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Copyright Law Amended 

In December of 1980, Congress amended the United States Copyright Law to per- 
mit computer programs to be copyrighted. We recently received this information from 
Radio Shack's legal department, along with a short summary of the changes and copies 
of the amendments. We thought this information might be of interest to you. 

In general we can summarize the changes by saying that the Copyright Law was 
amended to specifically state that a computer program was copyrightable. The amend- 
ment also provides that you, as the owner of a copy of a copyrighted program, are 
authorized to make copies of the program if you need to do so in order to use the pro- 
gram properly, or for archival and backup purposes. The new law states that you may 
transfer (give, sell, lease, etc.) a copy of the program to someone else only if you transfer 
all of your copies and rights to the program. That is, you cannot give a friend a copy of 
a copyrighted program and still keep a copy for yourself. 

As a matter of information, Radio Shack copyrights the Microcomputer News to 
prevent unauthorized commercial use of the material in the newsletter. You as an indi- 
vidual are free to use the information for your private benefit and to pass the information 
(including programs) along to other individuals for their private use. 

If you provide us with a program for publication, and we are contacted by a com- 
mercial organization that wishes to use the program (this has happened recently) we 
will refer the interested parties to you (if you give us an address and/or phone number). 
You are then free to make whatever arrangements are satisfactory between you and the 
persons interested in your program. 



Block Graphics Characters .... 8 

Details 8 

Backspace 8 

Linefeeds 8 

Carriage Returns 9 

Buffer Printing 10 

Wraparound 10 

Underline 11 



Incremental Spacing 11 

Positioning 11 

Repeat Data 11 

Graphics Mode 11 

Ignored and Unprintable Code 12 

Character Sets and Fonts ... 12 

View From the 7th Floor 2 



-i Ii-ii.Vi. W.ffHll-ii 



Retail Prices in this newsletter may vary at individual stores and dealers. 1 
The company cannot be liable for oictorial and tvoograohical inaccuracies. X 









fsJW 


7t 


UjJ ill" 



View From the 7th Floor 



by Jon Shirley, Vice President Computer Division 



In the past I have avoided commenting on the magazine 80 
Microcomputing which has often seemed to have a love/hate rela- 
tionship with Radio Shack. But this month's issue (March) had so 
much neat stuff that I could just not resist the temptation to write a 
little about this amazing issue. First off, in the publishers remarks, 
is a very nice and fair column, which in summary says that despite 
our warts, the TRS-80 is still the best micro to own. Thanks Wayne, 
we agree 100% . I might also mention that the same column com- 
mented on Tandy overseas and stated that we are number three in 
sales. Sorry Wayne, but we are definitely number two and if the 
reputed number one published their unit sales we might even be 
number one. 

But what else is in this issue? Lots! For example there is an 
interview with Mr. Kornfeld and another with our new president, 
Mr. John Roach. Both well worth reading. And there is more. There 
is a great rebuttal by Mr. H. C. Pennington, author of "TRS-80 Disk 
and Other Mysteries," to a reader's letter and Harv, we do not hate 
you in Fort Worth. We may disagree with you, TRSDOS 2.3 has 
been running a lot of business software for a long time with no 
problems, but every one is entitled to his/her opinions. 

A lot of the issue is devoted to disk operating systems. One 
"DOS Talk" compares TRSDOS and 5, that's right 5, other DOS's. 
Do any other computers have 6 available operating systems? 
Thanks for the nice comments in that article too, TRSDOS 2.3 does 
work exactly as the manual says, first time, every time and special 
thanks for outstanding rating of our documentation. It's even better 
for the Model III and Color Computer. And finally there is an article 
on the author of the original Model I TRSDOS. While that was a 
complicated story which is probably of little interest to anyone and 
one we would like to forget, I would like to point out that the author 
was paid by Shugart as called out in his contract. 

Part of the reason for commenting on this issue relates to a 
letter from a very angry Model I owner who wanted to know why 
we did not produce those 5 DOS's or why we did not write Mr. 
Pennington's book etc., etc. I suppose the major reason is 
resources. We may look large but back then we did not have a large 
staff and we were very busy writing, in house with our staff, Model 
II TRSDOS. When we could not get the author to fix TRSDOS 2. 1 
we stopped that project to produce 2.2 and then 2.3 And there is a 
difference between the two and it relates to how the real time clock 
interrupts are handled during disk access. But the real point is that 
there were books done and there were other disk operating sys- 
tems produced and that forms part of the support for the TRS-80. 
One important measure of the acceptance of any computer is how 
much outside support it has. It is unrealistic to assume that any 
computer company can produce all the software its users desire. 
Our big blue monster made by the world's biggest computer com- 
pany (who spends more on R and D than the total sales of any 
other company) runs a sort routine done by an independent soft- 
ware company. And guess what, so do over 50% of the other own- 
ers of that MAIN FRAME. All in all the TRS-80 has more support, 
both from Radio Shack and the outside world, than any other 
micro. 

I recently spoke in New York on a panel that was part of a 
conference called "Information Utilities '81." My theme was that 
communications is the key to the "hqme computer." The afternoon 
session featured speakers from CompuServe, The Source, and 
Dow Jones (plus another I did not have time to hear). There is really 
a lot happening with these databases and yes, this is another pitch 
for Videotex and CompuServe and Dow Jones. CompuServe 



has over 9,000 users as I write this and isgrowing 
all the time both in users and in information. Dow Jones has a 
huge database for the investor and I find I am using it daily. A lot 
more stores are now equipped to demo CompuServe and the 
Computer Centers should have Dow Jones up by now so take a 
look, it's free. 

In March we delivered our first Videotex host computer sys- 
tem. This is a four drive Model II attached to a 16 line telephone 
multiplexer that we designed and are making here. With one of 
these, up to 16 Videotex terminals can access the data stored on 
the Model II disks ... all at the same time and even when new 
data is being downloaded to the Model II. The first lucky customer 
is the Professional Farmers of America who publish an agribusi- 
ness (how is that for a buzz word) newsletter to over 75,000 sub- 
scribers. With this system they are equipping their customers with 
a Videotex terminal which can call in to the Model II from all over 
America and receive the newsletter electronically. The advantage, 
of course, is that the information is up to the minute and not 
dependent on our dear postal service. 

In average use one TRS-80 Model II host can handle one to 
two thousand Videotex terminals. Want one of these for your 
business? The entire system (without the terminals) sells for a lit- 
tle under $20,000 and we are taking orders. Just write to Fort 
Worth if you are seriously interested. By the way this is not a two 
way system, the terminals can only receive data, they cannot 
send data to be stored in the Model II. Give us a little more time 
for that. And in closing I would like to remind you of the TRS-80 
Source Book. We are going to print now with issue 3 with over 
2,000 applications software programs for all the TRS-80's 
included. If you have a program you want to list, just go to any 
Radio Shack, buy a source book (just $1.95) and fill out the 
enclosed blank. It's still $10 per listing and your program will be 
listed for a year. Judging from the number of new listings from 
writers who were in the first issue it must be working for them. 

Until next month. 

Back in February of this year, we published a list of Radio 
Shack Computer Centers. It turns out that some of the addresses 
and phone numbers we gave you were wrong. Below are correc- 
tions for the incorrect information, along with the addresses and 
phone numbers of some of our newest Computer Centers: 

New and Corrected Computer Center Numbers 

* Corrections # New Computer Centers 



* 


Arkansas, 


Little Rock 


Town & Country Shop C 


501/568-5694 


# 


Delaware, 


Wilmington 


3847 Kirkwood Hwy. 


302/999-0193 


* 


Florida, 


W Palm Beach 


227 1A Palm Beach Lk. Blvd. 


305/683-3100 


# 




Jacksonville 


8252 Arlington Expway. 


904/725-2594 


# 


Illinois 


Niles 


8349 Golf Rd. 


312/470-0670 


* 


Louisiana 


New Orleans 


327 St. Charles Ave. 


504/523-6408 


# 




Shreveport 


1545 Line Ave. 


318/221-5125 


# 


Maryland 


Catonsville 


One Mile West S/C 


301/788-3277 


* 


Massachusetts 


Worcester 


7 Gold Star Blvd. 


617/852-2030 


# 


Michigan 


Roseville 


31873 Gratiot Ave. 


313/296-6210 


# 




Flint 


G3298 Miller Rd. Yorkshire 


313/732-2530 


# 


Minnesota 


St. Paul 


6th & Wabasha 


612/291-7230 


# 


Nevada 


Reno 


3328 Kietzie Lane 


702/826-6327 


* 


New Jersey 


E. Brunswick 


595 A Route 18 


201/238-7142 


# 


New York 


Buffalo 


839 Niagara Falls Blvd. 


716/837-2590 


# 


North Carolina 


Charlotte 


3702 Independence Bl. 


704/535-6320 


* 


Ohio 


Cleveland 


27561 Euclid Ave. 


216/261-6900 


# 


Pennsylvania 


Scranton 


206 Meadow Ave, 


717/348-1801 


# 


South Carolina 


N. Charleston 


5900 Rivers Ave. 


803/747-5580 


# 


Tennessee 


Knoxville 


Cedar Bluff S/C 


615/690-0520 


# 


Texas 


Houston 


211-CFM 1960 


713/444-7006 


# 


Washington 


Spokane 


7706 N. Division #1 


509/484-7000 


* 


West Virginia 


Huntington 


2701 Vi Fifth Ave. 


304/523-3527 
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Printer Codes — The Inside Story 



The following major article on Radio Shack printer drivers 
and printers is running this month instead of the usual Product 
Line Manager pages for Model I/III, Model II, and Peripherals. 
These pages will return as usual in June. 

Last month in the Peripherals article we gave you some intro- 
ductory information about Radio Shack line printers and how the 
Models I and III handle information which is sent to printers. We 
also discussed the LPC/CMD program which is required by certain 
programs when they are used with newer Radio Shack printers. 
This month we would like to show you what happens when you 
"tell" the computer to print something on a lineprinter, and be 
more specific about the exact responses you can expect from the 
various Radio Shack line printers. 

The reasons we want to do this is to help clear-up some mis- 
understandings, and to give serious programmers information 
which may help them write programs that perform as the pro- 
grammer expects them to. 

Our discussion will cover several main points: 

When you LPRINT a character, . . . 

1) What happens in the printer driver 

2) What happens between BASIC and the driver 

3) What happens at the printer 



Anatomy of a Printer Driver 

What is a Printer Driver? That little beast is a machine lan- 
guage routine used by the computer to send individual characters 
to a printer. This driver is used whether you want to send a char- 
acter, a word, or a book to the line printer. The computer sends all 
information one character at a time. There is a certain amount of 
communication (via the status bits) between the computer and 
the printer so that the computer will not send characters faster 
than the printer can deal with them. 

We will give you general information for each of the com- 
puters Model I, II, and III. Please note that the sequence may not 
match the exact steps that the computer follows, however the 
ideas are what is important. 

We will use decimal code values, in particular: 

10 (OAH) represents a Line Feed (LF) 

1 1 (OBH) represents a Vertical Tab (VT) 

12 (OCH) represents a Form Feed (TOF) 

13 (ODH) represents a Carriage Return (CR — Which in a 

Standard Radio Shack printer is a new line (NL). Each 
time the printer executes a CR, it also executes a line 
feed LF). 

Also, the following words are defined: 
Increment — add one to the current contents of the particular 
memory location and put the new value into that mem- 
ory location. 
Set or Reset — Place the value indicated into the memory 

location indicated. 
In addition, there are two addresses in the Model I and four 
(the two from Model I plus two more) in the Model III which we 
need to be aware of: 

16424 — The maximum number of lines, plus one, to print on 

a page. 
16425 — The number of lines already printed on the current page 

(plus one in the Model III). 

16426 — (Model III only) The number of characters already 

printed on the current printer line 

16427 — (Model III only) The maximum number of characters to 

print on each printer line. 



Model I/III Memory Locations 



Location 


Initial Values 


Modi 


Mod III 


16424 
16425 
16426 
16427 


67 



XX 

XX 


67 

1 



255 



XX — In the Model I these locations are used for different purposes than in 
the Model III, and we are not concerned with those purposes here. 

Model I 

When the Model I system ROM printer driver receives a char- 
acter from BASIC or from a machine language routine, to be sent 
to a lineprinter, the following major events happen (Flowchart 1 is 
keyed to these explanations): 

1) The character is checked to see if it is a NULL (00 dec). 

2) If the character is not a null, go to step 3, otherwise put 
printer status in the A register, and RETURN to calling rou- 
tine. The null is NOT sent to the printer. 

3) Check to see if the character is an 1 1 or 12. If it is an 1 1, go 
to step 5, if the character is a 12, go to step 6. If it is neither 
an 1 1 nor a 12, go to step 4. 

4) a. Send the character to the line printer. Note that the 

ROM driver does not check to see if the character might 
_______ (Continued on Page 4) 

Model I Printer Drive 
Flowchart 



/ 



Character to 
Model I 
Driver j 





Get Printer Status. 
Put in Register A 



W Return to j 
Calling / 
Routine / 



Compute 
the Difference 

between 
16424 & 16425 



I Send 7 

/ Computed / 

/ numbe ' or / 

/ 10s to Printer / 




/ Return to / 
—J Calling »— 
/ Routine / 
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d. 



have been either a 10 or 13 before outputting it to the 
printer. 

b. After the character is output to the printer, it is checked 
to see if it was a 13. If the character was not a 13, go to 
step 4d. 

c. The character was a 13, increment memory location 
16425. Memory locations 16424 and 16425 are then 
compared. If they are equal, 16425 is reset to zero. 
Whether 16425 is reset or not, go to step 4d. 
Return to the calling routine. 

5) The character is an 1 1, we want to perform a move to the 
top of the next page (TOF). Note: TOF is the only type of 
vertical tab or form feed which is supported in a Radio 
Shack lineprinter. 

a. Compute the difference between the contents of 
memory location 16424 and the contents of memory 
location 16425. 

b. Once this value has been computed, the computer 
sends that number of character 10s to the printer. 

c. The memory location 16425 is set to zero (0). 

d. The computer returns to the calling routine. 

6) The character is a 12, we again want to move to the TOF. 
The method is a little different than shown in step 5. 

a. The contents of memory location 16424 is 
determined. 

b. If it is a zero, the computer sends a character (null) to 
the printer. The computer returns to the calling routine. 

c. If it is not a zero, then the procedure outlined in step 5 
is used to perform the TOF. 



Model III 



In the ROM printer driver, the following major events occur: 

(Flowchart 2 is keyed to these explanations) 

1) Is the character a control code «32), an alphanumeric 
character (31 < character < 128), or a special character 
(> 127)? If the character has a value greater than or equal 
to 32 then check to see if the value is greater than 127. If 

Model III Printer Driver Flowchart 



the value was greater than 127, go to step 7. If the value 
was greater than or equal to 32 but less than or equal to 
127, go to step 6, otherwise go to step 2. 

2) If the character is a 13 then go to step 5. 

3) If the character is NOT a 12 then go to step 7. 

4) The character is a 12, we want to perform a move to the 
top of the next page (TOF). 

a. Compute the difference between the contents of 
memory location 16424 and the contents of memory 
location 16425. 

b. Once this value has been computed, the computer 
sends that number of character 10s to the printer. 

c. Reset memory location 16426 to zero. 

d. Memory location 16425 is set to one ( 1 ). 

e. The computer returns to the calling routine. 

5) The character is a 13. 

a. Get the value in 16426. 

b. Is that value a zero? If it is a zero, go to step 7. 

c. The value was not a zero, change the 13 to 10 and go 
to step 7. 

Subtract 32 from the value of the character. 
Store new character from look-up table. 
Get the value in 16427. 
If it was 255 then go to step 7. 

e. If the values in 16426 and 16427 are not equal, go to 
step 7. 

Output a character 13 to the printer, reset 16426 to 
zero. 

Go to step 7. 

Output the character to the printer. 
Increment 16426. 

If the character was a 10 or a 13 then go to step 8. 
Return to calling routine. 
Reset 16426 to zero. 
Increment 16425. 

If 16424 and 16425 are equal (TOF) then reset 16425 
to 1. 
Return to calling routine. (Continued on Page 5) 



6) 



f. 
g- 

7) a. 
b. 
c. 
d. 
a. 
b. 
c. 



8) 
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Model II 

The basic information about what the System printer driver 
does is contained in the Model II manual. Of particular interest is 
the Technical information section on lineprinter SVCs (TRSDOS 
Chapter 4) and the section on the FORMS command (TRSDOS 
Chapter 2). 

Here is a summary of that information: 
We will use the following abbreviations: 

PL — Length of a page in lines 

LP — Maximum number of lines to be printed on one page. 
CL — The maximum number of characters to be printed on a 
single line. 

Model II allows several options while using lineprinters: 

1. Parallel or serial printers may be used. 

2. Using an SVC (95) you can set current line and current 
character counts to a desired value. 

3. Use a "Transparent mode" which sends all characters 
directly to the printer without any translation. Note: BASIC 
can not send a code 10 to the printer driver. 

4. Use a "Dummy" mode which tells the computer to ignore 
all printer output. 

5. Select whether or not to have an automatic line feed after 
each carriage return. Note: this is for printers which do not 
have the Radio Shack CR/LF feature and require that an 
LF be sent after each CR to get a new line. 

Most of these options can be selected using the TRSDOS 
FORMS command. They can also be selected by using the appro- 
priate SVC call. 

Actions taken by the printer driver: 

1) If PL and LP are the same, and PL does not equal zero the 
automatic Top of Form (TOF) is disabled. In this situation, 
if a character 1 1 or 12 is output, the printer driver will issue 
the proper number of 10 or 13 characters to advance the 
paper to TOF. 

2) If PL equals zero, then LP must also equal zero. When PL 
and LP are zero, the characters 1 1 and 12 are sent directly 
to the printer. This allows you to take advantage of TOF 
and Vertical Tab features which your printer may have. 

3) If PL is greater than LP, and neither of them is zero, an 
automatic TOF will be executed when the number of lines 
printed on a particular page equals LP. TOF is done by 
sending carriage return/line feeds to the printer. 

4) If CL is set to zero, the tab character (9 dec — HT) will be 
sent directly to the printer, and the CL counter will be incre- 
mented by one. In addition, no automatic carriage return 
is performed. 

5) If CL does not equal zero, the 9 character (HT) is translated 
into one to eight spaces to perform the tab function, and 
an automatic carriage return will be performed when the 
number of characters sent to the printer equals CL. 

6) The following decimal codes are "intercepted" by the 
printer driver and translated as indicated: 

9 — HT — From one to eight spaces are sent to the 
printer. 

11 — VT — TRSDOS sends enough carriage returns or 

line feeds to the printer to advance to the top of the 
next form. 

12 — FF— SameasVT(ll). 

13 — CR — When the current line is empty (no charac- 
ters printed since the last carriage return or line 
feed), the 13 is translated to a 10. In the auto line 
feed mode, a 10 is sent after each 13. 
141 — TRSDOS sends a carriage return to the printer. In 
the auto line feed mode, using this code allows 
you to send a carriage return WITHOUT a line feed. 
Remember that the normal Radio Shack BASIC CR 
includes an automatic LF. 



What happens between BASIC and the printer driver? 

In the Models I and III, BASIC outputs anything you give it (in 
the form of an LPRINT statement) directly to the printer driver 
without translation except CHR$(10) (a line feed) which BASIC 
translates to a CHR$(13) which is a carriage-return (NL in Radio 
Shack standard printers). In addition, BASIC adds a CHR$(13) 
to the end of any LPRINT statement which does not suppress 
the CHR$(13) with either a trailing semicolon (;) or a trailing 
comma (,). 

In the Model II, BASIC does not send the character 10 to the 
printer driver at all. Also, the character 9 (HT or horizontal tab) is 
translated into one to eight spaces. Model II BASIC, like Model 
I and III, adds a CHR$(13) to the end of any LPRINT state- 
ment which does not have a trailing semicolon ( ; ) or trailing 
comma (,). 

Please note that you can not send a character ten (CHR$( 10)) 
to the printer driver from BASIC in Models I, II, or III. 

How does this affect your programs? 

If you are programming on a Model II, you should not have 
any real problems. This is mainly due to the fact that the Model II 
TRSDOS FORMS command will allow you to send exactly what 
you want to your printer, except the CHR$(10) from BASIC. 

If you are programming on a Model I or a Model III, the 
primary "problems" which you can expect to encounter as you 
interface with a lineprinter are: 

1. Improper Top-of-Form. 

2. Too few line feeds. 

3. In certain conditions, the printer may "spew" 255 line 
feeds. 

The following procedures have been developed by our appli- 
cations programming staff to solve the first two problems (This is 
a review of information we gave you in April): 

To ensure proper action during a Top of Form, follow this 
procedure: 

A. Set the line counter to 1 at the beginning of the program 
by using the following instruction: 

POKE 1G425»1 

B. To do a TOF, follow this procedure: 

LPRINT CHR$( 12) 5 :P0KE 1G425, 1 

(Please note that the semi-colon (;) following the CHR$(12) is 
extrem ely importan t) 

To ensure that you get the proper number of line feeds: 

A. Do NOT use CHR$(138). If you have used CHR$(138), 
change it to CHR$(32). CHR$(32) is the code for a blank 
or space. CHR$( 138) was originally suggested as a way 
to "sneak" a CHR$(10) to our original lineprinter (LP I). It 
works well with that printer. However, if your software 
might be used with any other printer, do not use it. Also 
do not use LPRINT without something to be printed. If 
you need a single line feed, use LPRINT CHR$(32) or 
LPRINT" ". 

B. If you are going to use LPRINT CHR$(13) to generate a 
single NL, use it with a trailing semi-colon (;). Remember 
that BASIC adds a CHR$(13) to the end of any LPRINT 
statement which does NOT have the trailing semicolon 
or comma. 

Our application programmers assure us that these proce- 
dures will work with both Models I and III, all ROM versions and 
all "known" printers. 

The third problem occurs in both the Model I and Model III if 
the following conditions are met: 

1. Memory location 16424 and 16425 are equal. 

2. A TOF (Model I — CHR$(11) or CHR$(12), Model III — 
CHR$( 12)) is sent to the printer driver. (Continued on Page 6) 
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This situation does not happen very often, in fact you would 
probably have to be POKEing around with 16424 and 16425, but 
it is possible, and you should be aware of it. You can prevent this 
error from occurring by making sure that memory locations 
16424 and 16425 are not equal before you send a CHR$(11) or 
CHR$(12) to the printer. Under normal circumstances they will 
never be equal. 

What do the printers do? 

Printers have come a long way in a short time, and we see 
every indication that improvements are going to continue. When 
we compare our newer printers like the Line Printers VI and VII to 
our first lineprinter, the friction-feed, roll paper only printer that 
had a mechanically adjustable print head and a noisy motor that 
ran all the time, we find a lot of improvement in only three short 
years. 

Because of these improvements, Radio Shack is dividing its 
printers into three categories for purposes of character generation 
and code response: Data Processing, Word Processing, and 
Graphics. Each of these three categories of printer will have its 
own "standard" response to codes sent to it from the computer. 
Our purpose is to create classes of printers so software can be 
designed to work with a particular level and class of printer rather 
than with a specific printer. As the number of different printers 
which are available increases, and as the features of each printer 
continue to vary it can be very difficult for both the programmer 
and the end user to understand the type of printer which should 
be used for a particular piece of software. 

Some printers may use only one of these standards, and 
other printers might use all three. Further, some printers will con- 
tain only subsets of these standards, and (especially in our older 
printers) may respond to codes in a manner which is different 
than indicated by the standard. For this reason, we are presenting 
a chart of all current Radio Shack printers and their control code 
responses. We have also included information on how our var- 
ious printers fit with other portions of the new standards. 

Please realize that this standard is NEW and is not fully imple- 
mented on any printer which is currently in the Radio Shack 
Printer line. This standard tells you what we expect printers to do 
in the future. We are also including information on how the print- 
ers we have had up to this time fit with this new standard. 

Data Processing Printer 

The data processing capabilities of a printer are best used 
when we need to print a large quantity of information at the best 
(or fastest) possible speed. 



In a Data Processing printer, dot matrix characters are accept- 
able. Fixed pitch 5 characters per inch (CPI) elongated, 10 CPI 
ordinary, and condensed print (typically 16.7 CPI) will all be avail- 
able on a full Data Processing printer. The condensed character 
font allows you to print 132 characters in an eight inch print line. 
Underlining, proportional spaced character fonts, other character 
sets and fonts are not required and may or may not be present in 
a Data Processing printer. A typical Data processing printer will not 
have backspace capabilities. 

In a data processing printer, you will be able to mix ordinary 
(10 CPI) and elongated (5 CPI) characters on a single print line. 
You may not be able to mix ordinary and condensed characters 
on the same line. 

All line pitch control commands are stored but not executed 
by the printer. Upon receipt of the next LF code (0A Hex, 10 Dec) 
the paper is advanced in accordance with the stored pitch values. 

A full performance Data Processing printer will have the stan- 
dard Special character set (Table 2) and block graphics (Table 3) in 
addition to the 96 standard ASCII characters (Table 1 ). 
Word Processing Printer 

A Word Processing printer is used when we are less con- 
cerned with speed and are more interested in having neat 
"business-like" characters which will be fully formed or high den- 
sity dot matrix characters. One or more fixed pitch character fonts 
may be available. These character fonts may also include propor- 
tional spaced characters. A Word Processing printer will have 
backspace, subscript, and superscript capabilities. 

In a Word Processing printer, with appropriate software, you 
will be able to mix all character types on the same print line if you 
need to. 

All line pitch control codes are accepted and a line feed is 
executed (with the appropriate distance and direction) upon 
receipt in Word Processing modes. One of the purposes of this 
change (from the Data Processing mode of storing pitch informa- 
tion) is to make actions such as subscripting and superscripting 
relatively easy. 

An extended Special Character set (Table 2) will be available 
in a full Word Processing printer along with the standard 96 ASCII 
characters (Table 1). The Block Graphic characters are not 
required in a Word Processing printer. 

Graphics Printer 

A Graphics (or Bit Image) printer is used when we want to 
produce high density pictures or graphs using a printer. The cur- 
rent dot matrix graphics printer (LP VII) allows you to control 
seven pins in the dot matrix print head (dot addressable) in order 
to achieve maximum resolution. The bit image mode can be 

(Continued on Page 7) 
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HEX 


DEC 


SYMBOL 


Explanation 


I II 


IIA III IIIA 


rv 


V 


VI 


VII 


WP5Q 


QUME 


DWII 


QP 


QPII 


PLOT 


0A 


10 


LF 


Execute CR/LF 


+ + 


+ + + 


+ 


+ 


+ 


+ 


+ 


+ 


+ 


+ 




+ 


0D 


13 


CR 


Execute CR/LF 


+ + 


+ + + 


- + 


+ 


+ 


+ 


+ 


+ 


+ 


+ 


+ 


+ 


IB 36 
IB 38 
1B1C 


27 54 
27-56 
27 28 


ESC 6 
ESC 8 
ESCFS 


Select 6 LPI 
Select 8 LPI 
Select 12 LPI 




+ + 
+ + 


+ 


+ 
+ 
+ 


+ 
+ 
+ 




+ 


# 
# 
% 


+ 








1B0E 
IB OF 


27 14 
27 15 


ESC SO 
ESC SI 


Start Condensed 
End Condensed 




* 


* 


+ 
+ 


+ 
+ 










$ 
$ 






IF 
IE 


31 
30 


RS 


Start Elongated 
End Elongated 


@ 
@ 


@ + + 
@ + + 


@ 
@ 


+ 
+ 


+ 
+ 


+ 
+ 








+ 
+ 


& 




12 
13 
14 


18 
19 
20 


DC2 
DC3 
DC4 


Select Graphics 
Not Expected 
Select Word Proc. 












+ 















* ESC DC4 to select condensed, ESC DC3 to select ordinary characters 
@ ESC SO to select elongated, ESC SI to end elongated 

$ Use GS (Dec 29) to select 20 CPI, RS (Dec 30) to select 10 CPI, US (Dec 3 1 ) to select 5 CPI 
% ESC U is V 2 Forward LF ( 12 LPI) 

# See Qume manual for details 

& Use SI (Dec 15) to get elongated characters. 

QP II automatically returns to ordinary characters at end of line. 
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Graphics Control Code Standard — Explanations and Responses 



HEX 


DEC 


SYMBOL 


Explanation 


LP VII 


OA 


10 


LF 


Forward LF 


+ 


OD 


13 


CR 


Execute CR/LF 


+ 


IE 


30 


RS 


End Graphics 


+ 


1B0E 


27 14 


ESC SO 


Start Elongation 


+ 


IB OF 


27 15 


ESC SI 


End Elongation 


+ 


IB 10 


27 16 


ESC POS 


Positioning 


+ 


1C 


28 


FS 


Repeat Data 


+ 



The standard alphanumeric characters in Data Processing 
and Word Processing modes are the 96 standard ASCII (American 
Standard Code for Information Interchange) characters. These 
characters are shown in Table 1. 

In the Graphics or Bit Image mode, all characters starting 
from 32 Dec (20 Hex) to and including 127 Dec (7F Hex) are 
ignored by the printer. (Continued on Page 8) 

Table 1 
96 ASCII ALPHANUMERIC CHARACTER SET 



Brief note: some current (LP III) and future printers which are 
intended for sale in Japan as well as the United States and Europe 
have or will have the Japanese Kana character set. Where the Jap- 
anese Kana set is available, it may or may not require a repair 
center to select. The Kana set will replace the special character set 
as well as using some additional (otherwise unused) codes. 

Control Codes 

According to the American Standard Code for Information 
Interchange (ASCII), there are 34 single byte control codes and 
multiple byte ESC sequences in addition to a printer's printable 
character set. The new Radio Shack printer standards recognize 
23 of these codes and sequences, and others may be added as 
printers get smarter. There are two possible actions which can be 
taken by the printer when it receives unprintable or non-active 
codes. The unprintable or non-active code can be ignored, or 
it can cause a special character to print depending on the type 
of printer and its current operating mode. Please note that the 
concept of a special character for unprintable codes is not yet 
implemented in any Radio Shack printer. Current printers ignore 
the character or print a blank, depending on the printer. 

The following charts and tables will show the new Radio 
Shack printer standards. This is how we expect future Data Pro- 
cessing, Word Processing and Graphics printers to respond. Most 
of these charts will also detail how current Radio Shack printers 
respond to these new standards. 



HEX DEC 


CHAR 


HEX DEC CHAR 


HEX 


DEC CHAR HEX 


DEC CHAR 


20 


32 


SPACE 


38 


56 


8 


50 


80 


P 


68 


104 


h 


21 


33 


I 


39 


57 


9 


51 


81 


Q 


69 


105 


i 


22 


34 


" 


3A 


58 




52 


82 


R 


6A 


106 


J 


23 


35 


# 


3B 


59 


; 


53 


83 


S 


6B 


107 


k 


24 


36 


$ 


3C 


60 


< 


54 


84 


T 


6C 


108 


1 


25 


37 


% 


3D 


61 


= 


55 


85 


U 


6D 


109 


rn 


26 


38 


& 


3E 


62 


> 


56 


86 


V 


6E 


110 


n 


27 


39 


' 


3F 


63 


? 


57 


87 


W 


6F 


111 


o 


28 


40 


( 


40 


64 


@ 


58 


88 


X 


70 


112 


P 


29 


41 


) 


41 


65 


A 


59 


89 


Y 


71 


113 


q 


2A 


42 


* 


42 


66 


B 


5A 


90 


Z 


72 


114 


r 


2B 


43 


+ 


43 


67 


C 


5B 


91 


[ 


73 


115 


s 


2C 


44 


, 


44 


68 


D 


5C 


92 


\ 


74 


116 


t 


2D 


45 


- 


45 


69 


E 


5D 


93 


] 


75 


117 


u 


2E 


46 




46 


70 


F 


5E 


94 


" 


76 


118 


V 


2F 


47 


/ 


47 


71 


G 


5F 


95 





77 


119 


w 


30 


48 





48 


72 


H 


60 


96 


~ 


78 


120 


X 


31 


49 


1 


49 


73 


I 


61 


97 


a 


79 


121 


Y 


32 


50 


2 


4A 


74 


J 


62 


98 


b 


7A 


122 


z 


33 


51 


3 


4B 


75 


K 


63 


99 


c 


7B 


123 


{ 


34 


52 


4 


4C 


76 


L 


64 


100 


d 


7C 


124 


1 


35 


53 


5 


4D 


77 


M 


65 


101 


e 


7D 


125 


} 


36 


54 


6 


4E 


78 


N 


66 


102 


f 


7E 


126 


~ 


37 


55 


7 


4F 


79 


O 


67 


103 


g 


7F 


127 


Ignored 



Word Processing Control Code Standard — 


Explanations and 


Responses 


















HEX 


DEC 


SYMBOL 


Explanation 


LP I II IIA 


III IIIA 


IV 


V 


VT 


VII WP50 QUME 


DWII 


QP QPII PLOT 


0A 

1B0A 
IB 38 
1B1C 
IB IE 


10 

27 10 
27 56 
27 28 
27 30 


LF 

ESCLF 
ESC 8 
ESCFS 
ESCRS 


Vfe" For. LF 
Ve" Rev. LF 
Va" For. LF 
Vi2" For. LF 

V12" Rev. LF 


+ + + 


+ + 
SEL SEL 


+ 
+ 

+ 
+ 


+ 

SEL 
SEL 


+ 

SEL 

SEL 


+ 


+ + 
+ 

% 
% 


+ 

+ 
+ 


+ 


+ 


0D 


13 


CR 


Execute CR/LF 


+ + + 


+ + 


+ 


+ 


+ 


+ 


+ + 


+ 


+ + + 


08n 
lBn 


08n 
27 n 


BSn 
ESCn 


Backspace 

Incremental space 






+ 
+ 








+ + 
# 


+ 
+ 




+ 


OF 
0E 


15 
14 


SI 
SO 


Start Underline 
End Underline 






+ 
+ 


+ 
+ 








+ 
+ 


+ 
+ 




IF 

IE 


31 
30 


RS 


Start Elongated 
End Elongated 


@ @ 
@ @ 


+ + 
+ + 


@ 
@ 


+ 
+ 


+ 
+ 


+ 
+ 






$ & 
$ 


IB 11 
IB 13 
IB 14 


27 17 
27 19 
27 20 


ESCDCl 
ESC DC3 
ESCDC4 


Sel Prop. Char. 
Sel Ordinary 
Sel Condensed 


+ + 
+ + 




+ 

+ 
+ 










+ 






12 

13 
14 


18 
19 
20 


DC2 
DC3 
DC4 


Select Graphics 
Select DP Mode 
Not Expected 












+ 











SEL — Line feed response is selected but not executed until printer receives 0A Hex LF. 

% ESC U for Via" Forward LF, ESC D for V12" Reverse LF. 

# See Qume manual for details 

@ ESC SO to select elongated, ESC SI to end elongated 

$ Use GS (Dec 29) to select 20 CPI, RS (Dec 30) to select 10 CPI, US (Dec 3 1 ) to select 5 CPI 

& Use SI (Dec 15) to get elongated characters. 

QP II automatically returns to ordinary characters at end of line. 



IB 15 27 21 
IB 16 27 22 
IB 17 27 23 
IB 18 27 24 
IB 19 27 25 
IB 1A 27 26 



RESERVED 
RESERVED 
RESERVED 
RESERVED 
RESERVED 
RESERVED 
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Unprintable Codes 

In the new standards, in both Data Processing and Word Pro- 
cessing modes, the following ranges are generally considered to 
be "Unprintable" and will result in the printer printing a special 
"unprintable code" symbol — X. 

Unprintable Code Ranges: 

128 Dec (80 Hex) through 159 Dec OF Hex) 
192 Dec (CO Hex) through 223 Dec (DF Hex) 

In addition, if you are using Proportional spaced characters, the 
following code range is also unprintable: 

224 Dec (E0 Hex) through 254 Dec (FE Hex) 

In the Graphics mode, there are no "unprintable" codes, just 
a lot of "ignored" codes. Except for the seven control codes listed 
in the Control code chart, ALL codes from 00 Dec (00 Hex) 
through 127 Dec (7F Hex) are ignored in the Graphics mode. 
Since this includes all "seven bit" codes, eight bits (serial or par- 
allel) are required to use a printer's graphics (Bit Image) mode. 

Special Character Set 

Table 2 shows the 25 characters which form the new Special 
character set. It also shows each printer which has any of the char- 
acters and the decimal value to use for that character. This char- 
acter set will be available on all future Data Processing and Word 
Processing printers. In addition to the standard special characters, 
Word Processing printers will have five additional characters to 
complement the standard set. These five additional characters are 
(and the printers they are available on): 



Table 3 




Table 2 



Standard Special Character Set 






Character LP V VI QUME DW II 


Character 


LP V VI QUME DW II 


a 


161 


161 


- — 


128 


A 


177 


177 





219 


C. 


162 


162 


— 


156 


O 


178 


178 





220 


£ 


163 


163 


— 


163 


u 


179 


179 





221 


M- 


165 


165 


— - 


165 


c 


180 


180 





222 





166 


166 


96 


166 


a 


182 


182 





251 


w 


167 


167 


— 


— 


6 


183 


183 


. 


252 


t 


168 


168 


125 


168 


ii 


184 


184 





253 


§ 


169 


169 


123 


192 


3 


185 


185 





254 


© 


171 


171 


94 


171 


e 


187 


187 


— 


187 


'/4 


172 


172 


— 


172 


u 


188 


188 





188 


V2 


174 


174 


— 


174 


e 


189 


189 





189 


11 


175 


175 


124 


175 


/ 


191 


191 





191 


¥ 


176 


176 


— 


204 













Block Graphics Characters 

The Block Graphic characters are 31 special "graphic" sym- 
bols which are included as part of a Data Processing printer's stan- 
dard character set, and are not part of the Graphics Mode. These 
block graphic characters are optional in Word Processing printers, 
and are not available in the Graphics or Bit Image mode. Where 
the block graphic symbols are available, you can expect to see 
them only with fixed pitch character fonts and the various manip- 
ulations of those fonts. 

These symbols are currently available only in the Line Print- 
ers V (26-1165) and VI (26-1166). The symbols and their codes 
are shown in Table 3. 

DETAILS 

We have now described, in general what we expect our new 
printers to be able to do as they become available, as well as given 
you an indication of how our current printers fit the new stan- 
dards. Now we are going to expand on some of the ideas we 



Block Graphic Symbols 

Hex Dec Symbol Hex Dec Symbol Hex Dec Symbol Hex Dec Symbol 



E0 224 (Blank) 

El 225 ■ 

E2 226 ■ 

E3 227 ■ 

E4 228 ■ 

E5 229 S 

E6 230 J 

E7 231 - 



E8 232 m 

E9 233 I 

EA 234 I 

EB 235 f 

EC 236 1 

ED 237 b 

EE 238 J 

EF 239 ■ 



F0 240 

Fl 241 

F2 242 

F3 243 

F4 244 

F5 245 

F6 246 

F7 247 



F8 248 jl 

F9 249 H 

FA 250 + 

FB 251 f 

FC 252 A 

FD 253 ^ 

FE 254 k 



have given you, fill in some of the dark areas, and generally make 
all of this more useful to you (we hope). 

Backspace (BS n) 

Backspace is required in Word Processing printers but not in 
Data Processing printers. Backspace is not available in the Bit 
Image mode. 

Where backspace is available, it will usually take one of two 
forms. The backspace command may be a single byte command 
(BS) which simply tells the printer "backspace." This is the type of 
BS present on our daisy wheel printers. With this type of BS com- 
mand, either the printer only supports one size character (which 
means that the backspace distance is fixed), or the printer has 
some internal mechanism for "remembering" what characters 
have been printed, and how far the print head needs to be moved 
to backspace over them. 

The second type of backspace uses the "BS n" form of the 
command. For instance, dot matrix printers which have back- 
space capabilities can be backspaced from one to 255 incremen- 
tal or micro spaces (dots) by using the sequence BS n (08 n hex 
- 08 n dec, n is the hex or dec equivalent of a value from 1 to 
255 as appropriate and as limited by the particular printer being 
used — LP IV only allows 127 micro-spaces). When the BS n code 
is received, the printer will subtract n dot columns from the cur- 
rent print head position and move the print head accordingly 

If n equals zero, no backspacing is done. If the value of n is 
greater than the number of dot columns the print head has 
moved from the beginning of the line (Home position), subse- 
quent printing will begin at the beginning of the line. 

The BS (08) code is ignored in the Bit Image mode and the 
n will be treated as an independent graphics data byte. This 
should be considered an error condition and you should program 
to prevent this from occurring. 

If you wish to backspace one character or space, the value of 
n should equal the appropriate value for the character set and 
printer being used. On a printer using monospaced characters, n 
will be the number of incremental spaces defined by your printer 
manual for that particular character size. If you are using propor- 
tional spaced characters, the value of n will vary from character to 
character, requiring that your program "know" exactly what char- 
acters must be backspaced over. This may require that your 
program contain some type of "look-up" table containing the hor- 
izontal micro-space counts for each character in the printer's 
character set. Whether you use a look-up table or not, if you are 
going to use backspacing which has a BS n format, you must 
have some method of telling the printer how many micro-spaces 
to back-up. 

Line Feeds (LF, ESC LF, ESC FS, ESC RS, ESC 6, ESC 8) 

The only true line feed command is the LF (0A Hex - 10 
Dec). The other commands which are referred to as "line feed" 
commands are really pitch control commands. 

In a Word Processing printer, any of the "line feed" com- 
mands will result in an appropriate movement of the carriage, but 
we would like you to think of two separate things happening. 
First, the printer is given the pitch control information and second 
a line feed occurs which executes the pitch control information 
which was provided (after printing the current contents of the print 
buffer if there are characters in the buffer). (Continued on Page 9) 
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In the Data processing mode, this action is easy to see since 
the only "active" line feed command is LF (OA Hex — 10 Dec). All 
other line feed codes, such as eight pitch (ESC 8), are stored by 
the printer until an LF is received. When the LF command is 
received, the entire contents of the print buffer are printed, then 
the specified line feed action is taken using the stored pitch infor- 
mation. If no other line pitch information has been received, the 
LF command will cause a 6 Lines per inch (6 LPI) forward line 
feed. See Table 4. 

There are several things which you should realize about line 
feeds. First, you can not get a LF (Dec 10) from Model I, II, or III 
BASIC to the printer. The LF is generated by the printer when the 
computer sends a CR. (This is not absolutely true, there are times 
when the COMPUTER will send LFs to the printer, the computer 
just won't let you do it. Also, if you disable the automatic CR/LF 
function, in those printers which allow this to be disabled, the LF 
after CR will disappear and you will have to have some method 
of sending LFs to the printer.) 

The second thing to realize is that ESC 6 and ESC 8, require 



Table 4 

LINE FEED DESCRIPTIONS 



Hex 
Code 



OA 



1B0A 



1B1C 



IB IE 



IB 36 



IB 38 



Dec 
Code 



10 



27 10 



27 28 



27 30 



27 54 



27 56 



Symbol 



LF 



ESCLF 



ESCFS 



ESC RS 



ESC 6 



ESC 8 



Data Processing mode 



This is the only active 
line feed in the Data Pro- 
cessing mode. The pitch 
control codes set the 
information (distance 
and direction), but 
action is not actually 
taken until an LF is 
received. When the LF is 
received, the text in the 
print buffer is printed, 
and the line feed is per- 
formed in accordance 
with the stored pitch. 



The printer is set to do 
full (6 LPI) reverse line 
feeds. The reverse line 
feed is not executed. As 
soon as the ESC LF is 
set, the printer continues 
to receive data until a LF 
or CR is received, or a 
buffer full condition 
occurs. 

The printer is set to do 
half (12 LPI) forward line 
feeds. The Vz forward 
line feed is not executed. 
The print buffer is not 
printed. 

The printer is set to do 
half ( 12 LPI) reverse line 
feeds. The Vz reverse 
line feed is not executed. 
The print buffer is not 
printed. 

The printer is set to do 
full (6 LPI) forward line 
feeds. The full forward 
line feed is not executed. 
The print buffer is not 
printed. 

The printer is set to do 3 A 
(8 LPI) forward line 
feeds. The 3 / 4 forward 
line feed is not executed. 
The print buffer is not 
printed. 



Word Processing mode 



Any text in the print 
buffer is printed and the 
paper is advanced (Vfe 
inch) forward. If the 
printer is set to do an 
automatic CR when a LF 
is received, the print 
head will move to the 
beginning of the next 
line, otherwise, the 
paper will simply move 
Ve inch forward and 
printing will continue on 
the next line without the 
print head returning and 
staying at the beginning 
of the next line. 

Any text in the print 
buffer is printed and the 
paper moves (retracts) 
one full (Vfe inch) line in 



Any text in the print 
buffer is printed and the 
paper moves one half 
(V12 inch) line feed 
forward. 

Any text in the print 
buffer is printed and the 
paper moves one half 
( V12 inch) line feed in the 
reverse direction. 

This sequence is 
ignored. 



Any text in the print 
buffer is printed and the 
paper moves 3 A (Vs 
inch) line feed forward. 



you to send the ASCII value for the characters 6 and 8 (decimal 
54 and 56 respectively) and not the decimal values 6 and 8. This 
can be a little confusing if you look at the incremental space com- 
mands which also appear to have an ESC 6 and an ESC 8. The 
difference is that for incremental spacing, the ASCII symbols are 
ESC ACK and ESC BS and you send the printer decimal 27 6 and 
27 8 respectively Don't get these two sets of commands con- 
fused. We have tried to help by listing the decimal values in all the 
charts and tables in this article. 

The third thing to be aware of is that in the Data Processing 
mode, the pitch control commands will remain set until you 
change them. This can cause problems if you want to do a single 
reverse line feed, but forget to reset forward line feeds after you 
get the one reverse line feed that you wanted. (Use ESC 6 to reset 
forward 6 LPI.) 

In the Bit Image mode, the only line feed command available 
is LF (10 dec). This will advance the carriage some part of a nor- 
mal line feed in the forward direction. For the LP VII this is l/9th 
of an inch. In the Bit Image mode, all pitch control commands are 
ignored. 

Table 4 is a summary of the line feed/pitch control com- 
mands for the Data processing and Word processing modes. 
Remember that the Bit Image mode only has one line feed (0A 
Hex - 10 Dec, which moves the carriage in the forward 
direction). 

Carriage Return (CR) 

A CR code (0D hex - 13 dec) tells the printer to do two 
things. The first is to print the current contents of the printer buffer, 
the second is to execute a carriage return (return the print head to 
the beginning of the line). In most TRS-80 line printers the CR 
command also performs a third function, which is to advance the 
carriage to the next line (NL). See Table 5 for possible CR options. 

Printers using this standard will have several options for the 
CR command. These options will be changeable either through a 
user accessible pair of switches, or they may have to be changed 
by your computer repair facility Note: many early Radio Shack 
Printers are not changeable. 



Table 5 

CARRIAGE RETURN OPTIONS 



Status 



When: 
CR = NL 
& 
CR^CCR 



CR = NL 

& 

CR = CCR 

CR = CR 

& 

CR^CCR 



CR = CR 

& 

CR = CCR 



Description 



When a CR code (0D hex - 13 dec) is received, printable 
character information is printed before execution of car- 
riage return operation, then a line feed (One line (Ve inch) 
forward in Word Processing mode, previously set line feed 
from printer memory in Data Processing mode, and a fixed 
portion of a forward line feed in bit image mode) is exe- 
cuted. Subsequent printable characters are printed from 
the start of the new fine. 

Same as (CR = NL,CRi t CCR) in operation. But, if several 
CR codes are received successively without any printable 
characters, only the first CR is active. All succeeding CR 
codes with no intervening printable characters are ignored. 

When a CR code is received, any printable characters in the 
printer buffer are printed before execution of the carriage 
return (no line feed is executed). Subsequent printable 
characters will be printed beginning from the left margin on 
the same line unless a LF command is received. 

When a CR is received, any printable characters in the 
printer buffer are printed and then a carriage return is exe- 
cuted (no line feed is executed). Subsequent printable 
characters will be printed beginning from the left margin of 
the same line unless a LF command is received. If more 
than one CR command is received with no intervening 
printable characters, only the first CR in the series will be 
executed. All subsequent CR commands received with no 
intervening printable characters will be ignored. 



(Continued on Page 10) 
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Printer Code Response Chart 





Option 1 


Option 2 


Change- 
able 
? 


CHR$(13) 
CR = NL 


CHR$(13) 
CR = CR 


CR = CCR 

* 


CR^CCR 


LP I 


X 




X 




No 


LP II 


X 




X 




No 


Early 












LP III 


X 






X 


No 


Later 












LPIIIA 


X 




X 




Yes 


LP IV 


X 




X 




No 


LPV 


X 






X 


Yes 


LP VI 


X 






X 


Yes 


LP VII 


X 






X 


No 


WP50 


X 






X 


No 


DWII 


X 






X 


No 



If the printer response is changeable, the chart shows the way the printer 
is shipped from the warehouse. 

These changes are documented in our Service Manuals. You should let the 
R/S service center adjust the machine as your warranties are voided when the 
machine is opened by unauthorized personnel. The ability to make these 
changes will be a feature of all future Radio Shack Dot Matrix printers as long 
as there is a perceived need. 

*NOTE: This setting is provided to allow new printers to respond in a man- 
ner which is compatible with the response of the LP I. We do not recommend 
this setting for new printers. 

Getting down to business: 

The following conditions will cause the printer buffer to be 
printed. Also shown is what happens after each of these condi- 
tions is met. 



No. Conditions which cause 
Printing 



1 , When the number of dot col- 
umns or characters (depend- 
ing on how your printer 
counts) in the print buffer 
equals or exceeds the maxi- 
mum number of dots or char- 
acters, for your printer and the 
character font you are using, 
the buffer will be printed. If the 
last character received caused 
the count to exceed the maxi- 
mum, the buffer will be printed 
without that last character. 



If the print buffer becomes full, 
but the total number of dot col- 
umns to be printed does not 
equal or exceed the maximum 
number of dot columns for the 
selected character style, the 
printer will print the characters 
in the buffer. The buffer will 
now be empty. 

The buffer will be printed if 
there is at least one character in 
the buffer and a CR code is 
received. 



The buffer will be printed if 
there is at least one character in 
the buffer and a LF code is 
received. 



Operation after the buffer is printed 



After the buffer has been printed, the 
overflow character (if there was one) 
will be placed at the beginning of the 
print buffer. Any new characters 
which are received will be added to 
the buffer and the process will con- 
tinue. When the buffer is printed by 
the printer in this manner, wrap- 
around has occurred and the printer 
issued a NL command. The next line 
printed will begin at the beginning of 
the next line after the one just 
printed. You should remember that 
in the Data Proc. mode line feeds are 
performed using stored pitch 
information. This means that if wrap- 
around occurs in the Data Processing 
mode, the LF issued by the printer 
may be a partial LF and it could be in 
the reverse direction. Wrap-around 
IS an error condition! 

Characters which are received after 
the buffer has emptied in this man- 
ner will be printed on the same line 
as the characters just printed. (No 
carriage return or line feed is issued 
in this case and printing continues on 
the same line.) 



If CR = NL (normal setting) has been 
selected, the subsequent characters 
printed will be printed at the start of 
the next line. If the CR = CR option 
has been selected, the characters 
subsequent to the CR will be printed 
beginning at the beginning of the 
same line (unless a LF is received). 
This will cause overprinting. 

If LF = NL, subsequent characters 
printed will be printed at the start of 
the next line. If LF = LF then subse- 
quent characters will be printed 
beginning in the next character posi- 
tion on the next line. 



5. The buffer will be printed if 
there is at least one character in 
the buffer and the next charac- 
ter is not received within 
approximately one second (the 
amount of time will depend on 
the printer). 

6. The print buffer will be printed 
if there is at least one character 
in the buffer and a POS 
sequence is received. 



7. In the Data Processing or Word 
Processing modes, if there is at 
least one character in the buffer 
and the BS command is 
received, the buffer will be 
printed. 

8. In the Word Processing and 
Data Processing modes, when 
at least one character is in the 
print buffer, and a character 
font selection command (ESC 
DC1, ESCDC3, ESCDC4)is 
received, the buffer will be 
printed IF the selection code 
received is for a font which is 
different than the current char- 
acter font. If the selection code 
is for the current character font, 
no action is taken. 

9. In the Word Processing and 
Data Processing modes, if 
there is at least one character in 
the print buffer, and the Bit 
Image selection code (DC2) is 
received, the buffer will be 
printed. 

10. In the Bit Image mode, if there 
is at least one data byte in the 
print buffer, and the End Bit 
Image command (RS) is 
received, the buffer will be 
printed. 



After printing the buffer for this rea- 
son, subsequent characters will be 
printed on the same line. (No CR or 
LF will be executed.) 



After the printing is performed, the 
next character after the POS 
sequence will be printed on the 
same line, beginning from the posi- 
tion specified by the POS sequence 
(Overprinting will occur if the new 
head position is to the left of the old 
head position). 

The next characters printed will be 
printed on the same line, beginning 
at the starting point indicated by the 
BS command. Overprinting will 
occur. 

After the buffer is printed, characters 
received will be printed using the 
new character set. Printing will con- 
tinue on the same line until a LF or 
CR is received. Note: Some Data Pro- 
cessing printers cannot handle this 
function and may issue either an 
automatic NL or CR. In general, you 
can change character fonts or 
manipulate a font (condense or elon- 
gate it) in Word Processing printers, 
but you can only Elongate a font in a 
Data Processing printer. 

After the buffer has been printed, the 
Bit Image mode is selected and sub- 
sequent characters are treated as Bit 
Image data. Printing continues on 
the same line until a LF or CR com- 
mand is received. 

All Bit Image data in the buffer is 
printed, and the printer is set to Data 
Processing mode in 10 or 5 CPI 
depending upon whether the elon- 
gated characters are being used. If 
underlining was on before Bit Image 
mode was selected, it will still be on 
when Data Processing mode is 
entered. The next characters 
received will be printed on the same 
line (No automatic CR or LF is 
executed). 



Note 1: Conditions 1 to 6 are conditions which may occur in any of the Data Pro- 
cessing, Word Processing or Bit Image modes. 

Conditions 7 to 9 are possible in either Data Processing or Word Processing 
modes, but not Bit Image. 

Condition 10 can occur only in the Bit Image mode. 

Note 2: In the descriptions, "next line or NL" means a new line after a line feed 
operation (CR/LF). 

In Data Processing mode, if the reverse line pitch is available and has been 
set in the printer memory, line feed operations will cause the paper to 
move in reverse. 

Note 3: Repeat data as well as extra incremental spaces can cause a buffer full con- 
dition and force automatic printing of the print buffer. If this occurs, any of 
the repeat characters not printed on the first line will be printed at the begin- 
ning of the new line. 

Wrap-around 

Wrap-around is considered to be an error condition. That is, 
under normal circumstances wrap-around should never occur. If 
wrap-around does occur, and you did not intend for it to occur, 
you should check your program to find out why too much data 
was sent to the printer before a print command was issued. 

As mentioned in the section on what causes the print buffer 
to be printed, the printer will automatically print the buffer con- 
tents when the buffer is full. The buffer full condition exists when 
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the number of dot columns (or characters) to be printed equals, 
or exceeds the maximum number of dots (or characters) for the 
printer buffer in the selected character set. 

The purpose of this automatic wrap-around feature is to pre- 
vent the loss of print data. You should be aware of three things 
with regard to automatic wrap-around. 

First, if your program counts the number of lines which have 
been printed on a page (or uses the computer's automatic lines 
per page counter) this counter will not take the extra lines (printed 
because of automatic wrap-around) into account. It is the printer, 
and not the computer which issues the CR/LF for automatic wrap- 
around, and the computer has no way of knowing that automatic 
wrap-around has occurred unless your program keeps close track 
of the number of characters (or dot columns for proportional and 
big image data) that have been sent to the printer since the last CR 
operation. 

Second, if you are printing more than one style character on 
a print line, computing the number of dot columns or characters 
which are represented in the buffer can be complicated. If you will 
be using more than one style character in a single line, use caution 
or you may get un-wanted automatic wrap-around. 

The third thing you should be aware of relates to the Data 
Processing mode. When automatic wrap-around occurs in the 
Data Processing mode, the line feed operation is done in accor- 
dance with the stored line feed and pitch information. If you have 
set half reverse line feed in the Data Processing mode, and auto- 
matic wrap-around occurs, the line feed will be a one-half reverse 
line feed. 

Underline (SI, SO) 

In the Data and Word Processing modes, reception of the SI 
(OF hex - 15 dec) code by the printer will turn on the automatic 
underline feature and all subsequent characters will be under- 
lined. Please note that some printers will underline spaces as well 
as characters, while others (such as the DW II) do not underline 
spaces, even if the underline feature is selected. The underline 
function will continue (except while in Bit Image mode) until the 
SO (OE hex - 14 dec) code is received by the printer. 

Once the underline mode is set, it will remain set even 
though CR or LF commands are received. Further, while the 
underline mode will not work in the Bit Image mode, if underline 
was on before entering the Bit Image mode it will still be on when 
you exit the Bit Image mode. 

Incremental Spacing 

In the Word Processing mode, any character data can be left 
and/or right justified by using incremental spacing (or micro- 
spacing) commands. Incremental spaces are not required in Data 
Processing printers, and are ignored in the Bit Image mode. 

By using the incremental spaces, text can be adjusted within 
a line to move the rightmost character to a specified margin. Incre- 
mental spaces can be inserted between words or characters 
within a word by using appropriate software. The current Incre- 
mental space commands are: 



ASCII Symbols 


Decimal 


Hexadecimal 


Function 


ESC SOH 


27 01 


IB 01 


One micro-space 


ESCSTX 


27 02 


IB 02 


Two micro-spaces 


ESCETX 


27 03 


IB 03 


Three micro-spaces 


ESC EOT 


27 04 


IB 04 


Four micro-spaces 


ESC ENQ 


27 05 


IB 05 


Five micro-spaces 


ESC ACK 


27 06 


IB 06 


Six micro-spaces 


ESC BEL 


27 07 


IB 07 


Seven micro-spaces 


ESCBS 


27 08 


IB 08 


Eight micro-spaces 


ESCHT 


27 09 


IB 09 


Nine micro-spaces 



Positioning (ESC POS Nl N2) 

Positioning is required in a Graphics printer, but not required 
in a Word or Data Processing printer. 

When positioning is available, you can instruct the printer to 



move the print head to an absolute position relative to the 
"Home" or leftmost possible print position. 

After receipt of the positioning command, subsequent print- 
ing will begin from the specified head position. 

ESC POS(lB 10 hex— 27 16 dec) tells the printer that it is to 
position the print head. Nl contains the two most significant bits of 
the new head position and N2 contains the 8 least significant bits of 
that new position. At this time Nl will always be a value from to 
3 (only the least significant two bits in Nl are used, the higher six 
bits are always zero). See the chart below (and your printer 
manual): 





B 8 


B 7 


B 5 


B 5 


B 4 


B 3 


B 2 


Bi 


First Byte (Nl) 
Second Byte (N2) 



As 



A 7 



As 




A 5 



A4 



A 3 


A10 
A 2 


Ag 
A! 



Note 1: Depending upon the printer you may not be able to move the print 
head to each possible dot column using positioning. 

Repeat Data (FSN DATA) 

The repeat data function is not required in Data or Word Pro- 
cessing printers, and is required in a Graphics printer. 

If repeat data is available, a single character can be duplicated 
up to 256 times (depending on your printer) by using the FS N 
DATA command sequence. (If you are using the serial interface, 
this assumes you are using 8 bit interfacing. If you are using 7 bit 
interfacing (such as from the Color Computer) you can repeat a 
single character up to 127 times. FS is 1C hex or 28 dec. The N 
tells the printer how many times to repeat the character and will 
be a value from 00 - FF hex or - 255 decimal. Zero (0) hex or 
decimal will cause 256 repetitions in all modes (including both 7 
and 8 bit serial). 

The DATA byte is the byte which will be repeated. This 
should normally be a character in the printer's character or graph- 
ics set. In Data or Word Processing, if the DATA byte is in the range 
from to IF hex or 7F to 9F hex, or FF hex, the character will be 
changed to a "X" unprintable code mark. In the Bit Image mode, 
if the most significant bit of the value is a zero the repeat com- 
mand sequence will be ignored. 

Graphics Mode 

The graphics mode is the bit image or dot addressable 
mode. In the current bit image mode, you have control of seven 
pins in the dot matrix printhead. The pins to be used for printing 
a particular column are selected by the pattern of the least signifi- 
cant seven bits of the value you send to the printer (which is why 
we call it bit image). If you want to print only the top dot of the 
seven available dots, the seven bits would be 0000001. The most 
significant bit for graphics is always a one, so the value sent to the 
printer would be 10000001 binary, or 129 decimal. 

The Graphic characters begin at Decimal 128 (80 Hex, 
10000000 Binary) with none of the pins used and continue 
through 255 Dec (FF Hex, 11111111 Binary) with all of the pins 
used. The important thing to remember, when you are trying to 
visualize what a dot pattern looks like, is that the first digit (one- 
dot on or zero- dot off) starting from the right represents the top 
dot of the seven dot pattern. The second digit from the right is the 
second dot from the top, etc. until you have the seventh dot 
counting from the right which is the bottom dot in the column you 
will print. (See Drawing 1 for an example.) 

In general, each Hne of Bit Image graphics will take less ver- 
tical space (9 LPI vs 6 LPI in LP VII) than one standard line 
(remember, we are only printing seven dots). For this reason, Bit 
Image has its own line feed (Still Decimal 10, but less than one full 
line feed). The purpose of the special line feed is to let you create 
dense graphics without the vertical space between lines which 
you have in normal printing. 

The Line printer VII (26-1167) is the only Radio Shack printer 
which currently supports the Graphics mode. In the Line printer 
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VII graphics mode there are 60 horizontal dots per inch and 63 
vertical dots per inch. This gives you 3780 dots per square inch of 
resolution. Watch out Picasso! 

Drawing 1 

10 0000 1 
I 



6 
O 
O 
O 
O 
O 
O 




10 10 101 

1 1 ! I i i ' 

III ^ u 

II i ^® 

I i i ' — #^o 

i S i— — «— "-^-o 

j t m mm mmt W . Q 



• Dot Printed 
O Dot Not Printed 



Ignored and Unprintable Codes 

In each and every printer there are valid codes which the 
printer may receive, but for which the printer may not have a 
defined control function or printable character. For example, ASCII 
defines Decimal code 7 as being a bell. Radio Shack has sold only 
one printer, the Quick Printer, which had a bell function. If you 
should happen to be running a different printer with some soft- 
ware originally written for a Quick Printer, the printer might receive 
the Bell code 7. What is the printer going to do with this 
"unknown" (to it) code? 

In past printers there has not been any real standard for 
action to be taken by a printer when it gets a code which is not in 
the printer's command or character sets. 

With this standard (this is new and not yet implemented on 
any available Radio Shack printer) codes which are not in a 
printer's command or character sets will be defined as either an 
"ignored" code or as an "unprintable" code. If a code is to be 
ignored (and ignoring a code is a valid response of the printer to 
an unknown code), the printer will take no action. As far as the 
printer is concerned the code was never sent. If the code is in the 
"unprintable" category, the printer will print a special character 
which will usually look something like an hour-glass (X). The pur- 
pose of this character is to tell you that the printer has received a 
code for a control function or character which is not in the avail- 
able character set and which is not one of the codes to be ignored. 

In the case of our no bell printer and the bell code 7, future 
printers will simply print the "unprintable code" character (X). In 
general, printers will ignore Decimal codes 0, 1, 127 and 255. In 
addition, certain control codes and ESC sequences are sometimes 
ignored (For instance, if the printer is in the Data Processing mode 
and you send a DC3 control code, the printer will ignore it). Also, 
if you send a POS code which moves the print head past the real 
end of the print line, that code will be ignored. 

In Data and Word Processing modes, all unprintable or inac- 
tive codes (for that printer) will be printed using the special 
unprintable code character (X). This includes invalid unprintable 
codes between 00 Dec and 3 1 Dec. It also currently includes 
codes between 128 Dec and 159 Dec and any incorrect repeat 
sequences. The characters from 192 Dec to 254 Dec will be 
printed using the unprintable code character when the printer is 
using proportional space characters. In Bit Image mode, the 
unprintable code character is never printed. Instead unprintable 
codes are simply ignored. 



Character Sets and Fonts 

A printer may have several different character sets available. 
The common character sets are the 96 character ASCII set, the 
special character set, and the Block Graphics set. Within each char- 
acter set (especially ASCII), there may be one or more FONTS. A 
character font is one particular size and style of character. Among 
the common character fonts are one or more monospaced (fixed 
pitch) sets. In a fixed pitch font each character requires the same 
amount of horizontal space. That is, an I and a W are the same 
width. The "ordinary" character font for most printers is the stan- 
dard 10 characters per inch (10 CPI or 10 pitch for print wheels). 

In a daisy wheel printer, the pitch is limited to the fixed or 
proportional characters actually provided on the particular print 
wheel that you are using. Our daisy wheel printers do allow dif- 
ferent print wheels to have different pitches, but you have to sup- 
ply the proper software for either the WP-50 or the Qume printers 
to print with the new pitch setting. On the DW II you need only set 
the switch on the front panel (or send the proper control codes 
from software) to get 12 pitch spacing. 

In a dot matrix printer you will usually have a 5 CPI elongated 
character font (same height as regular characters, but twice the 
width), a condensed font, and an elongated condensed font avail- 
able. This is because dot matrix printers have much more flexibil- 
ity and can actually manipulate or change the fonts. It is possible 
to start with a certain character font (7x9 for example) and then 
manipulate that font to provide the varying horizontal pitches we 
have described, plus, conceivably several others. 

A second type of character font is proportionally spaced. In a 
dot matrix printer these characters will usually have a higher dot 
matrix print density than fixed pitch characters. This character font 
will often be described as n by x where x is a fixed number of 
vertical dots (typically 7 or 9) and n varies from character to char- 
acter (in an nx 9 set, the characters might vary from 9 to 23 hori- 
zontal dots per character with 9 vertical dots in the normal print 
size). Technology in the printer industry will soon be providing 
print heads with greater than nine dot vertical density. As these 
heads become available, watch for exciting new possibilities from 
dot matrix printers! 

The Qume daisy wheel printer is capable of supporting pro- 
portional spaced characters, but requires a good deal of software 
support to accomplish this. The DW II allows either the front panel 
switch or software to select the proportional space mode. The 
DW II handles the movement of the carriage properly using inter- 
nal firmware and therefore requires little software support in- 
order to print proportional characters (Note: right justification can 
entail considerable software support). 

The different character sizes and styles which are available in 
a dot matrix printer is a function of the printer's design. You have 
everything that is possible the day you buy the printer. This is not 
true for a Daisy Wheel printer. With a Daisy Wheel, all you have to 
do to change character sets or fonts is to buy a new print wheel. 
We have already announced six print wheels for the Daisy Wheel 
II, and more will be coming. If you have one of our WP 50 or 
Qume printers, there are scores of different print wheels available 
from several sources, including Daisytek Inc. of Richardson, 
Texas. (800-442-4502 in Texas or 800-527-4212 outside Texas). 

The printable characters in each of the printers which fit the 
new standard may be classified as follows: 

Standard 96 Character ASCII 

With a few exceptions which we will note below, all Radio 
Shack printers use the standard 96 character ASCII set. 

The most general exception to the 96 character ASCII set 
comes with regard to decimal values 91-95. Some of our printers 
print arcows for the standard ASCII characters, and three printers 
have both sets of characters available (LP IIIA, LP V and LP VI). If 
you want the alternate characters, you will need to have your 

(Continued on Page 13) 



TRS-80 Microcomputer NEWS, May 1981 



RadiaHtaelc 



The biggest name In Utile computers 



(TM) 



printer changed by a Radio Shack Repair Facility. The Mowing 
chart lists both the standard ASCII characters and the arrow char- 
acters. For each printer, if character is available we have given you 
the Decimal value of the character. If the character is not available 
we put a ' ." 



ASCII Character 


LP I 


II 


IIA 


III 


IIIA 


IV 


V 


VI 


VII 


WP50 


QUME 


DWII 


QP 


QPII PLOT 


[ 


91 


91 


91 


91 


R 


91 


R 


91 


91 


91 


91 


91 


91 





\ 


92 


92 


92 


92 


R 


92 


R 


92 


92 


92 


— 


92 


92 


— — 


] 


93 


93 


93 


93 


R 


93 


R 


93 


93 


93 


93 


93 


93 


— 




94 














94 


— 


— 


94 


94 


— 


94 


94 





— 


95 


— 


— 


R# 


95* 


95 


95* 


R# 


95 


95 


— 


95 


95 


95 — 


Arrow 






























Characters 






























<«- 


— 


94 


94 


R# 


91* 


— 


91* 


R# 


__ 


— 


_ 


— 


— 


91 — 


■»• 


— 


96 


96 


R 


92 


— 


92 


R 


— 


— 


— 


— 


— 


92 — 


♦ 


— 


95 


95 


R# 


93* 


— 


93* 


R# 


— 


— 


— 


— 


— 


93 — 


» 


— 


126 


126 


R 


94 


— 


94 


R 


— 


— 


— 


— 


— 


94 — 



R — Available requires Repair Facility to make change 

*AvailabIe in the alternate character set (UP) — 94, (LF) — 95. In the regular set, decimal 95 is the 
underscore character. 

#AvaiIable in regular character set (UP) — 94, (LF) — 95. In the alternate set, decimal 95 is the under- 
score character 

The next difference comes because four of our printers use 
a seven-bit parallel interface instead of an eight-bit parallel inter- 
face. Since the eighth (most significant) bit is missing, the Line 
Printer I (26-1150 and 26-1152), the Quick Printer (26-1153), the 
WP 50 (26-1157) and the Qume Daisy Wheel Printer (26-1157A) 
repeat their character sets for decimal values 128 through 255. 
This makes it look like you have two complete character sets 
(control codes and all) the first from decimal through 127 and 
the second identical set from 128 to 255. Note: The Line Printer II 
is an eight bit printer, but uses the eighth bit to designate elongated 
characters. The result is two not quite identical sets of characters, 
similar to the seven bit printers. 

The Line Printer I (26-1150 and 26-1152) and the Plotter/ 
Printer both have Upper Case Alphabetic characters only The Line 
Printer I translates lower case characters to upper case, while the 
Plotter/Printer ignores lower case characters completely 

The last set of variations to the 96 character ASCII set come 
from the Qume printer. The following chart shows all of the dis- 
crepancies between standard 96 Character ASCII and the stan- 
dard 96 Character Qume Word Processing printwheel (other 
series of Qume printwheels have different discrepancies): 





ASCII 


QUME 


DEC. 


Symbol 


Symbol 


92 


\ 


® 


94 


" 


© 


96 


- 


° 


123 


{ 


§ 


124 


| 


H 


125 


} 


t 


126 


~ 


© 



Conclusion 

What we have described in this later portion of this article is 
a new set of printer character standards. You should remember 
that these standards are new (and we hope not subject to very 
much change, other than the addition of provisions for new fea- 
tures) and not fully implemented on any printer. We have also 
tried to show you how our current and past printers meet these 
standards. We have not described every possible function on all 
existing printers. Check your printer manual for more information 
on how your printer responds to codes, and for possible addi- 
tional capabilities which your printer may have. 

After hearing about this article and what it purposed to do, 
one of our buyers described the task as being an Adventure game. 
That is, you are never sure that you have found all of the treasure 
or met all of the demons. We think we have covered all of the 
possibilities and made provision for the future. If we are wrong, 



the standards will be modified and we will let you know about 
those changes. 
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Pocket Computer 



(From Page 21) 



During the past week I have had several phone calls from 
Pocket Computer owners who suggested a method to help you 
avoid forgetting a PC program name which you have stored on 
tape. Prior to recording your program, use the built-in microphone 
in your tape recorder to record verbally the name of the program 
(spell it out phonetically so there won't be any doubt) and a short 
description of what it does. Now stop the recorder and reconnect 
it to the interface and proceed with the normal CSAVE function 
... I record it twice, one to load and the second to verify. If you 
do this before each program you save on a tape, you can locate 
a particular program easily by using the CUE feature on most 
recorders to find your voice description. I have tried this and it 
works quite well . . . the computer simply ignores the voice sig- 
nals on the tape when trying to read in a program. 

Before closing for this month, here's a little feature of the 
Pocket Computer which relates to the INPUT and AREAD state- 
ments (see OM pages 52 and 53, 69 and 70 respectively) when 
using a numeric variable. When input to a variable is from the key- 
board, a number of things may happen before the variable is 
actually loaded. If you enter a single number (one or more digits) 
into the display it of course will go directly into the variable. How- 
ever, if you enter a mathematical expression such as 5*8, the 
math is done first and the result (40 in this case) is put into the 
specified variable of the INPUT or AREAD statement. This is men- 
tioned in the illustration at the top of page 53. It is also possible to 
use another numeric variable as input by typing its letter on the 
keyboard, and the contents of the memory location will be loaded 
into the specified variable of your INPUT or AREAD statement. 
Here again, you can combine "this feature with math functions, 
such as P * 2.5, as input to a numeric variable. If P contained 10 
then the variable in your statement would end up with 25. 

Well, I hope this month's tidbits of information prove useful 
to you as you explore new tasks to program on your Pocket Com- 
puter ... so until next month . . . more Pocket Power to you! 

PS. Everyone who has purchased a TRS-80 Pocket Com- 
puter is entitled to receive a one year FREE subscription to this 
newsletter. So, if you know someone who isn't getting it, tell them 
to send a copy of their sales receipt or other proof of purchase 
along with a short note to the Editor at P.O. Box 2910, Fort Worth, 
TX 76101. We'll see that they get on the mailing list and I'm sure 
they will appreciate it. 
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Model I/III Bugs, Errors, 
and Fixes 

Model III TRSDOS Manual 
(26-1063) 

Page 102 of the Model III TRSDOS Manual lists a 300 Baud 
terminal program. An error in line 65 of the program causes out- 
put characters to be echoed to the screen, but not through the RS- 
232 to the host computer. Change line 65 of the program to read: 

G5 DEFUBR2 = 6:H0055 

Model III BASIC 

There are some restrictions on using BASIC in a DO file. If 
BASIC is part of your DO file, you can answer "How many files?" 
and "Memory size?" inside your DO file. In addition, after these 
have been answered, you can have RUN "filename" or LOAD 
"filename" (but not both) as part of your DO file. However, if one 
of these is used, it would have to be the last item in the DO file. 

EXAMPLE: 



BUILD TEST (OTTER) 

Hit BREAK to exit 

Type in up to B3 characters 

BASIC (ENTER) 

Type in up to S3 characters 

( OTTER) 

Type in up to 63 characters 



(ENTER) 

Type i n up to B 3 ch aracters 

RUN "PROG/BAS" (OTfERl 

Type in up to S3 characters 

(BREAK) 

TRSDOS R ead v 

DO TEST (ENTER) 



Another application for a DO file with BASIC could be to write 
a program within the DO file for execution under BASIC (Do not 
use AUTO line number). 

EXAMPLE: 



BUILD TEST2 (ENTER) 

Hit BREAK to exit 

Type in up to G3 characters 

BASIC (OTTER) 

Type i n up to S3 char a c t e r s 

10 FOR X = i TO 10 (OTTER) 

Type in up to B 3 c h a rac t e r s 

20 PRINT X: NEXT X (OTTER) 

Type in up to S3 characters 

RUN (OTTER) - 

T y p e in up to S3 characters 

(BREAK) 

TRSDOS Re ady 

DO TEST2 (OTTER) 

Again, RUN would have to be the last command in the DO 
file. LIST could be substituted for RUN, but then LIST would have 
to be the last command. (You could not use both.) 

These restrictions are due to the fact that once you get into 
BASIC, BASIC will continually scan the keyboard for the (BREAK) 
key character. During this scan, any other characters will be 
thrown away This is because the DO file does not know that 
BASIC is scanning the keyboard and in turn BASIC will "drain" the 
DO file. Instead of the keyboard supplying the key input, charac- 
ters are supplied by the DO file. 

Tape Payroll (26-1504) 

Version 1.2 of Tape Payroll gives erratic line-feeds when 
printing out checks or reports with newer printers. 



Follow the following procedure to correct this problem: 

1. CL0AD thePRPROC program into me mory. 

2. At READY, type LI ST 2130 and press (ENTER) . 

3. Look at the line until you find CHR$ ( 1 38 > 

4. At READY type ED I T 2130 and press (ENTER) . 

5. Press the (SPACEBAR) until the cursor is on top of the C in 
CHRS $( 138). Type (9) ®, pr ess the (D key once, and type 
in GD (SPACEBAR) © then press (ENTER). 

6. Follow steps 2 through 5 and replace theCHR$(138)sin 
lines 2170, 2190, 3250 and 3900. 

7. CS AUE the program onto a fresh tape and use this new tape 
from now on. 

8. C L A D the P R T T program into mem ory. 

9. At READY, type LI ST 1080 and press (INTER). 

10. Look at the line until you find CHR$ ( 1 38 ) . 

11. At READY type ED IT 1080 and press (ENTER) . 

12. Press the (SPACEBAR) until the cursor is on top of the C in 
CH R$( 138) . Type (9) ®, press th e (D key once, and type 
© (SPACEBAR) © then press (ENTER) . 

13. Follow steps 9 through 12 and replace CHR$ ( 1 38 ) in lines 
1160 and 1180. 

14. CSAVE the program onto a fresh tape and use this tape 
from now on. 

Inventory Control System 
(26-1553) 

For Model III only, in version 1. 1 of ICS if the prompt "Is the 
Date Set Correctly" is answered with N for no, and you then give 
the correct date, the machine hangs up and RESET must be 
pushed. 

To solve this problem, make the following changes to the ICS 
program: 

1. At TRSDOS Ready, type BASIC and press (ENTER) . 

2. Answer the prom pts as usual. At READY, type LOAD 

"ICS" and press (ENTER) . 

3. At READY, type LI ST 1S0 and press (ENTER) . 

The screen will show: 



160 POKE 16454iVAL(LEFT$(DT$»2)): 
VAL( RIGHT* (DT*»Z)) 



POKE 1645S 



4. At READY, type ED IT 180 and press (ENTER) . 

5. Press the (SPACEBAR) until you are on top of the first 4 in 
1 E454. Press © (9) © (2) © ®. Now press the (SPACEBAR) 
until you are on t op of the 4 in 1 8452. Press © (9) © (2) 
© (2), and press (ENTER) . 

6. At READY, type LIST 1S0 and press (ENTER) . The line 
should now read: 

160 POKE 16924 »VAL(LEFT*(DT$>2)): POKE 16922 » 
MAL ( RIGHTS (DT$ .2)) 



7. At R e a d v, type LIST 170 and press (ENTER) . 

8. The screen will show: 

170 POKE 16453»VAL(MID$(DT*i4»2)) 



9. At R e a d y, type EDIT 170 and press (ENTER) . 

10. Press the (SPACEBAR ) until the cursor is on top of the 4 in 
18453, then press © ® © (2) © © an d pres s (ENTER) . 

11. At Ready, type LI ST 170 and press (ENTER) . 

12. The screen should show: 

170 POKE 16923 »VAL(MrD*(DT$»fl»2)) 

13. To sav e your changes, type SAME" ICS" and press 
(ENTER) . 

Disk Payroll (26-1556) 

The non-EIC version of both Model I and Model III Disk Pay- 
roll has erratic line feeds when printing checks with Line Printer VI 

(Continued on Page 15) 
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and the LPC driver. This occurs especially during check printing 
and may also occur with the Daisy Wheel II and Line Printer V. 

To solve this problem, we suggest that you get the most 
recent EIC version of Disk Payroll. This is available through your 
Radio Shack store as stock number 700-3003 and is available for 
a suggested retail price of $50.00 with proof of purchase for 
26-1556. 

If you do not wish to get the EIC version, make the Mowing 
changes to the PR4CHK program: 

l.At TRSD0S READY, type in BASIC and press (ENTER) . 
Answer the two prompts as usual. 

2. When RE ADY ap pears on the screen, type LOAD " PR4CHK " 
and press (ENTER) . 

3. When READY appears again, type LIST 380 and press 
(ENTER) . 

4. The screen will show line 380. In line 380, locate the phrase 
CHR$(138). 

5. At READYjjtype EDIT 380 and press (ENTER). Now press 
the (SPACEBAR) until your cursor is on top of the © in 
CHR$ ( 1 38). Pre ss ® ®. Now, press the CD key once and 
then QD (SPACEBAR) © to get " " and press (ENTER). Your line 
is now correct. 

6. Follow steps 3 through 5 and change all of the CHR$ ( 1 38 ) s 
in lines 440, 460, 820, 840, 900, 920, 940, 5030, 5060, 5100, 
5180, 5200, 8000, 8015, and 8045. 

7. Replace lines 500, 980, 5220 and 8060 as Mows: 

500 FORQL=1TO10: LPRINT" ! 
980 F0RQL=1T0B: LPRINT" " : 
5220 F0RQL=1T0G: LPRINT" ' 
LPRINT" 



i NEXT (ENTER) 
NEXT (ENTER) 
: NEXT (ENTER) 



8060 FORQL=1TO10: 



NEXT (ENTER) 



8. Check each of the changes carefully to be sure it matches what 
we have here. To save the c hanges you have made, type 
SAUE"PR4CHK" and press dNTJE. 



Profile (26-1562) 



On certain newer printers, Profile version 3.0 on both Models 
I and III is generating extra linefeeds when it does a Top-of-Form. 
To correct this in the Model III version, follow this step: 

1 . At T R S D S Ready, enter the Mowing command: 

PATCH PRINT (ADD=79EE,FIND=8A»CHG=20) (ENTER) 

This will permanently correct the Model III version. 
To correct the Model I version, follow this procedure: 

1. Insert a TRSDOS diskette other than your Profile diskette into 
the machine. 

2. At TRSDOS READY, type BASIC and press (ENTER). 

3. At READY, after you have answered the start-up prompts, 
enter the following BASIC program: 

10 REM "PROF IX" 



20 


CLEAR 1000 


30 


OPEN "R", 


1 » " I N I T " 


40 


FIELD 1. 


100 AS FD$ 


50 


GET 1.1 




G0 


CH$=FD$ 




70 


MID$(CH$ i 


7Bfl)=CHRt(BB) 


80 


MID$(CH$» 


81il)=CHR$(0) 


90 


LSET FD$= 


CH$ 


100 


PUT 1 ,1 




110 


CLOSE 




120 


OPEN "R" 


,1 ."PRINT" 


130 


FIELD 1, 


255 AS FD$ 


140 


GET 1.7 




150 


CH$=FD$ 




160 


MID$(CH$ 


ii255il)=CHR*(32) 


170 


LSET FDS 


i = CH$ 


180 


PUT 1,7 




190 


CLOSE 





4. Now type S A U E " P R F I X " and press (ENTER) . 

5. At READY, remove the TRSDOS diskette and place the Profile 
program diskette in dri ve 0. 

6. Type RUN and press (ENTER). 

7. The program PROFK will change the Profile programs to cor- 
rect the problem. When the screen shows READ Y, the changes 
are complete. 

8. Press the RESET button and run Profile as instructed in the 
manual. 



Scripsif (26-1563) 



In both Models I and III, Scripsit versions 1.0 and 3.0, the 
Widow suppress mode does not work with Double Line spacing. 

This problem can not be corrected in the current versions, 
but can be avoided by using an odd number of lines in the Top 
Margin. 

For instance, when the format line reads: 

>TM=G RM=72 LS=2 WS=Y 

The widow suppress will not work, but if the line reads: 

>TM=5 RM=72 LS=2 WS=Y 

widow suppress will work correctly. 



VisiCalcf(26-1566) 



If you wish to print your VisiCalc screens using Scripsit, use 
the / P F format in VisiCalc. This will save the sheet in Printing 
Format, enabling you to load the sheet into Scripsit by using file- 
name/PRF. 

If you have been having problems printing VisiCalc on a 
Serial printer, but your Scripsit works alright with the serial printer, 
this method may also allow you. to print VisiCalc files by going 
through Scripsit. 



T-Bug (26-2001) 



The T-Bug manual contains a misprint on page 29: 

DDB05 LD H >( IX+IND) 

should read: 

DDGG05 LD Ht( IX+IND) 

Model II Bugs, Errors, 
and Fixes 

Inventory Management System 
(26-4502) 

There are problems printing purchase orders using the Line 
Printer VI. The problem is that random line-feeds and extra lines 
are appearing. This same problem may also occur with the Daisy 
Wheel II, Qume, and the Line Printer V, and similar problems can 
be expected with future new printers. 

To solve this problem, make the following changes to the 
ORDER/BAS program: 
l.At TRSDOS READY, type BASIC and press dNJJR) 

2. At Ready, type LOAD "ORDER/BAS" (ENTER) 

3. At Ready, type LIST 5300 (ENTER] 

4. The screen wffl show: 

5300 FOR X=1T0LF:LPRINTCHR$(138):NEXT:RETURN 

5. At Ready, type EDIT 5300 (ENTER) 

6. Press © ©. The cursor should now be on the C of the 
CHR$( 13 8 ) . Press ® ®. Press (D once, then press QD 
(SPACEBAR) © to get " " then press (ENTER) 

7. At R e a d y , type LIST 5300 (ENTER) (Continued on Page 16) 
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8. The screen will show: 

5300 FOR X=1T0LF:LPRINT" ": NEXT : RETURN 



9. At Ready, type LIST 5170 (ENTER). 
10. The screen will show: 

5170 LF=56-ML-LC:GOSUB5300:LPRINTLL$ 



11. At Read y, type ED IT 5170 (ENTER) . 

12. Press the (SPACEBAR) 5 times, pre ss © ( 5), and press (ENTER) . 

13. At Ready, type LIST 5170 (ENTER) 

14. The screen will now show: 

5170 LF=55-ML-LC:GOSUB5300:LPRINTLL$ 

15. At Re a d y, type SAME " OR DER/ BAS" (ENTER). 

16. At Ready, type SYSTEM (ENTER) . 

17. The line changes are now complete and saved. You may now 
continue normal operation. 



Payroll (26-4503) 



The list of employees prints all names except those in which 
the last name ends with the letter "Z." 

To correct this problem, in line 1740 of the "ADD" program, 
change the upper case "Z" to a lower case "z." The corrected line 
should read as follows: 

1740 FORI=1TO200:MID$(C1$.I)=CHR$(I): 

H$(I)=STRING$(30,"z"):NEXTI:IFLOF(3XlTHEN1800 
ELSEF0RN=1T0L0F(3) :GET3fN:PRINT@(3 »Z5) i 

MID$(F3$»1.30)i:MID$(H$(N) .1 ,30) =MID$(F3$ .1 ,30) : 
NEXT:N=0 

After the line has been corrected, and a copy of the program 
saved, change or add to employee information to force the pro- 
gram to resort the data. 

In Payroll versions 1.0 and 1.1 State Unemployment tax is 
limited to two decimal places. Some states need three decimal 
places for this rate. 

To allow three decimal places, change the FL = 3 in lines 
445 and 760 of the INPUT program to read FL = B. Be sure you 
save a copy of the corrected INPUT program. 

Accounts Receivable (26-4504) 

Users of Accounts Receivable versions 1.0 and 1. 1 are getting 
ERROR 94s in different places. There are two known reasons for 
getting an Error 94 in a data file. 

1. Right after setup the user has defined the system capacity 
as 2 or 3 drives, and did not have blank formatted diskettes in 
drives 2 and/or 3. 

2. During. normal operations (e.g. print function, posting, 
invoices) the user hits the reset key or ends the job abnormally. 

If the error occurs because of condition 1, the only answer is 
to setup all over again, making sure the system capacity and the 
number of drives you desire to use are equal, and that you have 
blank formatted diskettes in the appropriate drives. 

If the error occurs because of condition two, first try: 

1. Use TRSDOS to LIST all nine of the data files. 

2. If an Error six is encountered, list that data file until the EOF 
appears. If this does not cure the problem, use a good backup 
and re-enter any data since that backup was made. 

3. If an Error 31 is encountered when trying to list a file, look 
in all directories for the first file listed when you got the Error 94. If 
the file is not found, the file has been lost and you should go to a 
good backup. 

Accounts Payable (26-4505) 

When updating the Accounts Payable to the General Ledger, 
an error message "Total Entries exceeds 50. G/L TRANSFER 



ABORTED" will be received if the number of Account Payable 
entries exceeds 50. 

To solve this problem, change line 190 of the "APGLPOST/ 
BAS" program to read: 

190 A=A+l:A(A)=GA:Vs(A)=GC*:GOSUB240:IFA=lTHENRETURN 
ELSEIFNE<24THENPUT2:A=0:A(2)=0:g*(2)=0D0:NE=NE+l: 
RETURN 

Then add line 195: 

195 NX=0:M«(2)=-T*:Ts=-GCs:A(2)=G(l):GOSUB240:PUT2: 
GOSUB230:G=G-1:A=0:A(2)=0:M»(2)=0D0:NE=0:NX=1: 
RETURN 

Be sure to save a copy of the corrected program. 

When selecting invoices by Discount/Due date, using version 
1.0, ALL invoices are selected. Also after adding 500 vendors, cus- 
tomers have tried to delete 10 then re-add 10 vendors and could 
not. Instead they received a "Cannot add to Vendor List, Vendor's 
List Full" error message. 

To correct these problems, use the following steps: 

1. At TRSDOS Ready, type BASIC (ENTER! 



2. At R e a d v, type L0 AD " A PS / B AS^_pTER) 

3. At Ready, type LI ST 12212 (INTER) 

4. The screen should show: 

12212 GET1.K:IFDUO0ANDDD<>0ANDABS(CVI(I3$)X = DUAND 
CMI(I4$X = DDTHENGOSUB12300 



5. At Ready, type EDIT 12212 (ENTER) 

6. The screen will show 12212, press © © CD. The cursor 
should be on the T of THENGOSUB 1 2300. Press (D once 
and type the following: 

ANDABS(CVI ( 13$) ) >0ANDABS(CMI ( 14$) ) >0 CENTER) 



7. At Ready, type LIST 12212 (ENTER) 

8. The screen should show: 

12212 GET1 >K:IFDU<>0ANDDDO0ANDABS(CUI(I3$)X=DUAND 
CMI(I4$X=DDANDABS(CMI(I3$))>0AND 
ABS(CVI ( 14$) ) >0THENGOBUB12300 



9. At Ready, type LIST 12225 (ENTER) 
10. The screen will show: 

12225 IF DU=0ANDABS(CMI(I4$)X = DDTHENGOSUB12300 



11. At Ready, type EDIT 12225 (ENTER) 

12. The screen will show 12225. Press © (D CD. The cursor 
should stop on top of the T in THENGOSUB 1 2300 . 
Press the CD key once and type the following: 



ANDABSfCVI ( 13$) ) >0ANDABS(CMI ( 14$) ) >0 fENTER) 



13. At Ready, type LIST 12225 (ENTER) 

14. The screen will show: 

12225 IF DU = 0ANDABS(CMI(I4$)X = DDAND 

ABS (CVI ( 13$) ) >0ANDABS (CMI ( 14$ ) ) >0THENGOSUB 12300 



15. At Ready, type LIST 3540 (ENTER ) 

16. The screen should now show: 

3540 GET1 .K :GOSUB2030: IFK = M JTHEN 1 800ELSEK = CVI ( I J$) 

GOTO3540 



17. At Ready, type EDIT 3540 (ENTER) . Press ® ® CD. The 
cursor should be on top of the 1 in 1800ELSE. Press ® 
3D then D once. Type: 

RETURN (INTER] 



18. At Ready, type LI ST 3540 (ENTER) 

19. The screen should now show: 

3540 GET1 >K :GOSUB2030: IFK =VJTHENRETURNELSEK=CMI ( IJ$) : 
GOTO3540 



20. At Ready, type SAME" A PS/BAS" (ENTER) 

21. At Ready, type SYSTEM (ENTER) 

22. The line changes to A P S / B A S are now complete. 

In version 1.0 there is also a problem in the APCHECKS/BAS 
program. The program now points to "Align Checks" after you 

(Continued on Page 17) 
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have updated vendors. The following changes will modify the 
program to point to "Return to Main Menu": 

1. If you just completed the changes to APS/BAS you should still 
be in BASIC. If you are not in BASIC, follow step 1 above to 
load BASIC. 

2.AtReady,typeL0AD"APCHECK5/BAS" (ENTER) 

3. At Ready, type LI ST 4002 (ENTER) 

4. The screen wffl now show: 

4002- IFEP = -3THENEP = 5:AM = 1ELSEAM=0:EP = 5 



5. At Ready, type ED IT 4002 (ENTER) 

6. Press © ©• The cursor should now be on top of the 5 in 
the first EP = 5. Press © ® then © (5). The cursor should 
now b e on top of the 5 in the second EP = 5. Press © ® 
(ENTER) . 

7. At Ready, type LIST 4002 (ENTER) 

8. The screen will now show: 

4002 IFEP=-3THENEP=4:AM=1ELSEAM=0:EP=4 



9. At Ready, type LIST 7002 (ENTER) 
10. The screen will now show: 

7002 IFABS(EP)=1OREP=5THENEP=0 



11. At Ready, type EDIT 7002 (ENTER) 

12. Press © ©. The c ursor s hould now be on top of the 5 in 
EP = 5. Press © © JNTER). 

13. At Ready, type LI ST 7002 (ENTER) 

14. The screen wffl now show: 

7002 IFABS(EP)=1OREP=4THENEP=0 



15.AtReady,typeSAgE"APCHECKS/BAS" (ENTER) 

16. At Ready, type SYSTEM (ENTER) 

17. The line changes APS are now complete, and you can con- 
tinue normal operation of the program. 

Profile II (26-4512) 

In version 1.0 of Profile II, after setting up a screen format the 
operator will be unable to add any information to fields 1 
through 09. These fields are shown on the screen but will not 
allow any input. 

If you will go back to the screen format and change the fields 
from 01 to 1, 02 to 2, etc., this will solve the problem (the leading 
zero is causing the problem). 

On more than one occasion a Profile user has set-up Profile 
(version 1.0) on a single disk, only to find later that the number of 
records requires more than one drive. The following directions 
explain how to expand your Profiles II from 1 drive to several. In 
Profiles it is possible to COPY data files from one drive to another 
and then kill the file where you don't want it without any prob- 
lems. Profile II will find the file wherever it is. 

Use the appropriate procedure, depending on the number of 
segments you have in your Profile II data file, and the number of 
drives you wish to use. In each of the following, the *** should be 
replaced by the file name you are using for your data file, padded 
on the right with enough zeros to make eight characters. 

TWO SEGMENTS— ONE EXPANSION DRIVE 

If you have two segments and 1 expansion drive the follow- 
ing should be copied from drive to drive 1 to allow for maxi- 
mum capacity. After these files have been copied to drive 1 KILL 
them off Drive 0. MAKE A BACKUP BEFORE YOU BEGIN. 



***/DAT 










***/PMP 


***/PM2 


**7PM3 


**7PM4 


***/PM5 


***/ptD*r 


***/PR2 


***/PR3 


***/PR4 


***/PR5 


***/LBl 


***/LB2 


***/LB3 


***/LB4 


***/LB5 



THREE SEGMENTS— ONE EXPANSION DRIVE 

If you have three segments and 1 expansion drive the follow- 



ing should be copied to drive 1 to allow for maximum capacity. 
After these files have been copied to Drive 1 KILL them off Drive 
0. MAKE A BACKUP BEFORE YOU BEGIN. 



***/DAT 
***/PMP 



***/DA2 
***/PM2 



*/PM5 



***/PM3 ***/PM4 

FOUR SEGMENTS— ONE EXPANSION DRIVE 

If you have four segments and 1 expansion drive the follow- 
ing should be copied to drive 1 to allow for maximum capacity. 
After these files have been copied to Drive 1 KILL them off Drive 
0. MAKE A BACKUP BEFORE YOU BEGIN. 

***/DA2 ***/DA3 

***/PMP ***/PM2 ***/PM3 ***/PM4 ***/PM5 

***rpzyT ***/piD~) ***/PR3 ***/pp4 ***/p-pc 

***/LBl ***/LB2 ***/LB3 ***/LB4 ***/LB5 

TWO SEGMENTS— TWO EXPANSION DRIVES 

It you nave two segments and 2 expansion drives the follow- 
ing should be copied to drives 1 & 2 to allow for maximum capac- 
ity. After these files have been copied to Drive 1 and 2 KILL them 
off Drive 0. MAKE A BACKUP BEFORE YOU BEGIN. 

Drive 1 ***/KEY 
Drive 2 ***/DAT 

THREE SEGMENTS— THREE EXPANSION DRIVES 

If you have three segments and 3 expansion drives the fol- 
lowing should be copied to drives 1, 2, & 3 to allow maximum 
capacity. After these files have been copied to Drive 1, 2, and 3 
KILL them off Drive 0. MAKE A BACKUP BEFORE YOU BEGIN. 

Drive 1 

***/DAT 

***/PMP 

Drive 2 
***/DA2 

***/PRT 

Drive 3 

***/DA3 

***/LBl 



*/PM2 



7PR2 



7LB2 



*/PM3 



7PR3 



7PM4 



*/PR4 



7LB4 



7PM5 



*/PR5 



7LB5 



***/LB3 
FOUR SEGMENTS— TWO EXPANSION DRIVES 

If you have four segments and 2 expansion drives the follow- 
ing should be copied to drives 1 and 2 to allow for maximum 
capacity. After these files have been copied to Drive 1 and 2 KILL 
them off Drive 0. MAKE A BACKUP BEFORE YOU BEGIN. 

Drive 1 



***/PMP 


***/PM2 


***/PM3 


***/PM4 


***/PM5 


***/pDT 


***/PR2 


***/PR3 


***/PR4 


***/PR5 


**VLB1 


***/LB2 


***/LB3 


***/LB4 


***/LB5 


Drive 2 










***/DA2 


***/DA3 









FOUR SEGMENTS— THREE EXPANSION DRIVES 

If you have four segments and 3 expansion drives the follow- 
ing should be copied to drives 1,2, and 3 to allow for maximum 
capacity. After these files have been copied to Drive 1, 2, and 3 
KILL them off Drive 0. MAKE A BACKUP BEFORE YOU BEGIN. 



Drive 1 

***/DAT 

***/PMP 

Drive 2 
***/DA2 

***/pD*r' 

Drive 3 

***/DA3 

***/LBl 



**7PM2 



*/PR2 



7LB2 



*/PM3 



*/PR3 



7LB3 



7PM4 



7PR4 



*/LB4 



*/PM5 



*/PR5 



7LB5 



NOTE: THE *** REPRESENTS YOUR FILE NAME. 
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Scripsif 26-4530 



Two problems have been identified in Scripsit when you use 
horizontal format files. 

The first is an error in storing tabs in both 1.0 and 1.0a. When 
a tab stop is set on certain columns, the cursor will disappear and 
the system will lock-up. This forces you to RESET the computer. 
This does not damage anything on the disk! However, any text that 
had not been written to the disk is lost. 

The second problem will correct problems in 1.0 only in which 
text is lost during printout even though it looks fine on the video 
and/or Print prompts appear garbled. 

To solve these problems, follow this procedure: 

1 ) RESET your system and insert a Scripsit diskette. 

2) Answer t he DAT E prompt. 

3) Press the (HOLD) key 

4) Answer the TIME prompt (or press (ENTER) ). 

5) At TRSDOS Ready carefully enter the following patches: 

To correct the tab problem (1.0 and 1.0a): 

PATCH SCRIPSIT A=9C9E F=78C62i C=CD30DC 

PATCH SCRIPSIT A=9CB2 F=2802FG80DG21 C=CD40DC000000 

PATCH SCRIPSIT A=DC30 F=0000000000000000000000 

C=7BFE5F3003CG21C9CG42C9 
PATCH SCRIPSIT A=DC40 F=00000000000000000000 

C=2805F680DG42C9D621C9 

To correct the loss of text problems (1.0 only): 

PATCH SCRIPSIT A=C9GB F=CDCBCG10FB C=CD10DB0000 
PATCH SCRIPSIT A=DB10 F=000000000000 C=F5783DFD8G2C 
PATCH SCRIPSIT A=DB16 F=0000000000000000 

C=322F90783DFD8G37 
PATCH SCRIPSIT A=DB1E F=0000000000000000 

C=323A90F148C3CDCG 

PATCH SCRIPSIT A=CGD0 F=CDEflCG C=C330DB 

PATCH SCRIPSIT A=DB30 F=000000000000 C=F5C5E52B2BBE 

PATCH SCRIPSIT A=DB38 F=000000000000000000 

C=C24ADB2BBE23CA/1ADB 
PATCH SCRIPSIT A=DB4i F=000000000000000000 

C=237E8177E1C1C353DB 
PATCH SCRIPSIT A=DB4A F=000000000000000000 

C=E1C1F1CDE4CGC3D3CG 
PATCH SCRIPSIT A=DB53 F=000000000000 C=FD352DC3ECCG 



CENTER) . Scripsit win load. 

7) BACKUP the patched Scripsit disk! 

Another problem which is occurring in both version 1.0 and 
1.0a is that the printer is not pausing between pages. This hap- 
pens particularly when merging documents. If you have already 
checked the print menu and made sure there is a Y for the ques- 
tion "PAUSE^ BETWEEN PAGES?" then insert the following 
patches 
Solution: 

1. Reset the system at SWAP diskettes 

2. Answ er the Date Prompt 

3. Press (HOLD) and press (ENTER) for the Time Prompt 

4. Type in the following patches at TRSDOS Ready: 

PATCH SCRIPSIT A=C40F F=FD210390 C=C380DB00 



PATCH SCRIPSIT A=DB80 F=t 

C=E521FFFF2242BDE1 

PATCH SCRIPSIT A=DB88 



C = FD210390C313M 



5. Type STARTUP and press (ENTER) 

6. Scripsit is now patched and you can continue operation. 



COBOL Compiler (26-4703) 

There are two areas of possible interest for COBOL users. 



Binary data in ISAM key fields causes loop in COBOL. This is 
an unusual programming practice but can be allowed with the 
following patches. Note: do not make this PATCH unless you are 
sure you know how to handle binary data in ISAM key fields. 

Pu t in the following patches at TRSDOS Ready pressing 
(ENTER) after each patch. 

PATCH RUNCOBOL A=502A F=FA31503E0i C=CDE0830000 
PATCH RUNCOBOL A=B3E0 F=0000000000000000 
C=2B9G3E01D03E04C9 

Problem: 

Executing RUNCOBOL from a DO file allows operator the 
freedom to press BREAK at any time. If ISAM file indexes are 
being updated, pressing BREAK will destroy the file so that it is 
unusable. To disallow this possibility, use the following patch: 

Solution: 

PATCH RUNCOBOL A=7077 F=CD C=CC 

This patch prevents RUNCOBOL from being executed in a 
DO file. 

(Continued on Page 20) 



6) After making these patches, type STARTUP and press 



jjNew Customer Service 
I Phone Lines 

Customer Service has added people and telephone lines to 
better support our customers. To facilitate handling of calls, we 
now have separate phone numbers for Model I/III Business Soft- 
ware, and for Model II Business Software. Here are the numbers: 

Model I/III Business Software 1-800-433-5641 

In Texas 1-800-772-5973* 

Model II Business Software 1-800-433-5640 

In Texas 1-800-772-5972* 

All Other Calls 1-800-433-1679 

In Texas 1-800-772-5914 

*These Texas WATS lines will not be available until May 20, 
1981. Until that time, Texas Business Software users should con- 
tinue to use the 800-772-5914 number. 

When you call Customer Services, we will be able to help you 
better if you have the following information readily available: 

1) Your Name. 

2) Your phone number, where we can reach you. 

3) What TRS-80 Computer System you are using and the 
number of disk drives, if applicable. 

4) The name and stock number of the software package you 
are using. If you know the version number, we would also 
like that information. 

5) What Error Codes you have received. 

6) How the error occurred, and the function you were exe- 
cuting when it occurred. 

7) Information about any patches or program corrections 
you may have made. 

These items are particularly important if you are calling one 
of the four new Business Software numbers. These new numbers 
have been set up so that your call will be answered by a Customer 
Service Representative and not a receptionist. The two All Other 
Calls lines are the old WATS numbers, and will continue to be 
answered by a receptionist who can route the call to the most 
qualified available Customer Service Representative. We are trying 
to handle a large volume of calls and any help you can give us 
is appreciated. 
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Product Line Manager's News 



Remember the "little" house we built last month using the 
LINE command? Well, hold onto your hat, 'cause we're going to 
do it again this month using a couple of other commands in the 
arsenal of Extended Basic. But, before we proceed, Mr. George A. 
Bums of Ozark, MO has brought to our attention a small misprint 
in the PINBALL (26-3052) manual. After editing the playing field, 
the manual says you can press P to begin playing your creation. 
What, in fact, you must do is first press the space bar to get back 
to the Edit menu, then select P to play Our thanks to you George 
and future reprints will be corrected. Now, on with the house- 
building. 

As in previous articles on Extended Basic, we must first set 
up our program to go into the graphics mode: 

1 DRAW"S4" 
5 CLS 

10 PCLEAR 4 
15 PMODE 3 »1 

17 PCLS 

20 SCREEN 1 ,0 

As you might have noticed, we have added another instruc- 
tion (line #1) to our setup routine. (More on this a little later. For 
now, just type it in.) Again, for those who might have missed last 
month's issue or who are proud, new owners, this is what we 
have done: 

Line 5 clears the text screen. 

Line 10 clears 4 "pages" of memory for graphics. 

Line 15 selects resolution mode 3 (128x192 with 4 colors), start- 
ing the display on page number 1. 

Line 17 clears the first page of graphic memory. 

Line 20 switches the video to the graphics mode and selects one 
of the two color sets available. (In this case: red, yellow, 
green, blue.) 

Back to that funny DRAW statement . . . 

The syntax in programming Extended Color Basic for the 
DRAW command is as follows: 

DRAW line — where "line" can be a string constant or a substring. 
You can specify 8 different directions and distance, the color you 
want drawn, change the angle, or change the scale to which it is 
drawn. You can also move the cursor without drawing a line or 
draw a blank line (using the background color) or draw the line 
without updating the position of the cursor. 

The directions are entered using the following keys to move 
various directions: 

M= Move the cursor position 
U= Up 
D = Down 
L = Left 
R = Right 

E = 45 degree angle 
F = 135 degree angle 
G = 225 degree angle 
H = 315 degree angle 
X = execute a substring and return 
C = Color (1-8 depending on graphics mode selected) 
A = Angle (0-3 rotates command & subsequent commands: 
0=0 degrees 

1 = 90 degrees 

2 = 180 degrees 
3= 270 degrees 



S = Scale (1-62 based on V^ths) 

S4= full scale ( 4 A) 
N = No update of cursor position 
B = Blank (no draw, just move) 

We'll also be using the PAINT command in this version of the 
program. Its syntax in Extended Basic is: 

PAINT (x,y),c,b 

"x" and "y" are coordinates on the screen with x being 0-255 and 
y being 0-191. "c" is the color you wish to PAINT with and b is the 
color you wish to PAINT to. If, while PAINTing, the computer 
meets a color other than the one it is to PAINT to, it will PAINT 
right over it. 

These instructions might sound a little bit awesome at first, 
but as we write our program, they should become clearer. So . . . 

We'll proceed with the program we started at the beginning 
of this article. Enter these lines: 

30 DRAW"C4iBM0»185iR255" 
35 DRAW"BU70iL255BLlB05L50" 

A quick explanation of line #1 first: we have specified S4 or 
full scale drawing. If we left this line out, the computer would have 
defaulted to full scale anyway It will stay in this scale mode until 
we tell it to change to another scale. 

In line 30, we're telling the computer to select color 4 (C4; 
red, in this color set) to draw the line with. Next in line 30 we tell 
the computer to move the cursor (M) using a blank line (B ; no 
draw, just move) to position 0, 185. Finally in line 30, we're saying 
to move the cursor right 255 spaces (R255). The punctuation is 
defined as: the comma between the x and y coordinates is 
required, but the semi-colons between the directions is not. (They 
make it easier to read the program when keying in or editing your 
program.) 

In line 35, we're instructing the computer to DRAW a blank 
line up 70 spaces (BU70). Since we did not specify a starting 
position in this DRAW command, the computer uses the current 
cursor position to start from. If we would have started the pro- 
gram with this statement, the computer would have started 
DRAWing the line from the center of the screen. Then we tell it to 
move left 25 spaces drawing a line (L25). Then move 180 spaces 
to the left without drawing a line (BL180). And finally continue 
drawing the line 50 more spaces to the left (L50). 

**Since these instructions are string constants (they don't 
change), they must be enclosed in quotes.** 
Enter lines 40-85: 

40 DRAW ! 'BR50iD20iR150iU30iL50;BD30iU50iL100iD50" 

50 DRAM"BU50iE15!R100iG15" 

55 DRAW"E15!F15iD5" 

B0 DRAW"BL30'iBD15iE15iR50iG15" 

G5 DRAM"E15iF15!D23" 

70 DRAM"BL30!BD6": FOR X = i TO 7: DRAW"R4 iUl" : NEXT X 

80 DRAW"BL74!BD7!UZ0iR40iD20iU5iU0iU5iR40iU5!L40" 

85 PAINKGO .80) i2 .4: PAINK 155 ,103) .2 ,4 

In lines 40-80 we are telling the computer to move the cursor 
around the screen leaving a trail of red behind it where necessary. 
Notice that we (I) have been keeping track of where the cursor 
has ended up and what we (I) must do to get it to where it needs 
to be without destroying what we've created so far. 

In line 85, we've introduced the PAINT instruction. Basically 
all that was done was: pick an x,y coordinate that you know is 

(Continued on Page 20) 
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Bugs, Errors, Fixes (FromPageis) 
TRSDOS (26-4910) 

Some users have requested an option to remove the TIME 
and DATE question from their TRSDOS 2.0 and 2.0a disks. 

The following PATCH will omit the DATE and TIME request 
on boot-up. It should be noted that if this PATCH is applied, there 
will be no CREATION DATE or UPDATE DATE in the Directory 
unless you take care to type it in via the DATE command. There- 
fore, confusion could arise on the age of the user's programs. 

1. At TRSDOS Read y, type the following patch 
PATCH SYSRES/SYS A=2367 F=73 C=CA 



2. Press CENTER) 

WARNING THIS PATCH SHOULD NOT BE USED WITH ANY 
RADIO SHACK PRE-PACKAGED PROGRAMS. RADIO 
SHACK PROGRAMS USE THESE FUNCTIONS (DATE 
AND TIME) INTERNALLY. THIS PATCH IS ONLY FOR 
YOUR OWN PROGRAMS. 

The following patches can be made to TRSDOS versions 2.0 
and 2.0a if you need a 75 baud utility under the SETCOM utility. 

These patches are designed to allow the option of selecting 
75 BAUD under the SETCOM utility. This requires the deletion of 
4800 BAUD as a selection since space does not allow an addi- 
tional option. If circumstances require 4800 BAUD at some time 
or another, you simply reverse the Find and Change values to 
restore 4800 BAUD. 

1. At TRSDOS Ready type the following patches 

PATCH SYSTEM64 R=14 B=118 F=1A47 C=D007 



and press (ENTER) 

PATCH SYSTEM/SYS 



R=104 B=125 F=C012 C=4B00 



and press (ENTER) 
2. This completes the patches. 



Color Computer 



(From Page 19) 



inside the area to be PAINTed (60,80) & (155,103), choose the 
color you wish to PAINT (2 which is yellow) and the color you 
wish to PAINT to (4 which is red in this color set). Type in: 

999 GOTO 999 

and RUN the program as it is so far. What you should see is that 
familiar shaped house with the garage attached and a garage door 
without any windows. If you watch closely you can see the roof 
on the house and garage being colored yellow (depending on the 
color adjustment on your TV set). 

Press the BREAK key to get out of the program. Continue 
entering the rest of the program with lines 90-120: 

90 DRAW"BL100!BU36iR96":FOR X = l TO G: 

DRAH"BU2iBR2iBL96iR96":NEXT X 
100 DRAW"BL8iBD32iR47":F0R X = l TO G: 

DRAW"BU2iBR2;BM7!R47":NEXT X 
110 DRAW"BDa3;BL119iU22iR10iD22iBUlliBL2iDl" 
120 DRAM"BD5iBLfl7 5U12iR3fl!D12!L34iBR56iU12iR35iD12iL35" 

In this series of lines, we have drawn in the door (with door 
knob) and the downstairs picture windows. From this point on, 
we will start telling the computer where to position the cursor 
using x,y coordinates. (It's easier than keeping track of where the 
cursor has ended up.) 

At any point, you can stop entering lines and run the program 
to see what is happening. Line 999 that you entered will hold the 
display in a continuous loop. Simply press BREAK to continue 
entering program lines. 

Enter the following lines to DRAW the upstairs windows, the 
driveway, street and sidewalk, plus windows on the garage door: 



130 DRAN"BM63»100!D/liR6iU4!LG": 

FOR X=l TO 4: DRAW "BRIG !D4 !R6 \UH iLG 
140 DRAW"BM154.135;D1;M": 

FOR X = l TO 11: DRAW'DiiM 

FOR X=l TO 12: DRAW'Ul 5R4 
150 DRAW"BM95il35!DliU": 

FOR X = i TO 15: DRAITD15L4 
1G0 FOR X = l TO 7: DRAH"DliL4" 
170 DRAW"BM194.135iDliLfl* 1 : 

FOR X=l TO 23: DRAW'Dl iLfl 
180 DRAM"R1B0" 
190 DRAW"BM15B»122!R12iBR5JRl 



NEXT 
NEXT 



: NEXT 
NEXT I- 



NEXT 



NEXT 



X: DRAN"L44": 



DRAW "RGB" 

DRAW"L65" 



Lines 200-250 add the final touches to an otherwise ordinary 
house: 

200 PAINT(205 tl25) »2 >4 
210 PAINT( 198*133) ,2 ,4 
220 PAINT( 148,133) ,2 ,4 
230 PAINT( 152 .95) ,2 ,4 
240 PAINT( 175 ,137) ,3,4 
250 PAINT(0 ,0) ,3 ,4 

Line 200 PAINTs the side of the garage (2 which is yellow). 
Line 2 10 PAINTs the front of the garage (2 again). Line 220 PAINTs 
the front of the house (correct, . . . yellow). Line 230 PAINTs the 
side of the house showing (right again, yellow). Line 240 PAINTs 
the sidewalk, driveway, and street (3 which is blue). Finally, line 
250 PAINTs in the sky (again 3 which is blue). 

If you were to change line 1 to: 

1 DRAW"S2" 

or half-scale (%) and run the program, (you need to take out the 
PAINT instructions in line 85 and 200-250) you will get an idea of 
what Scale can do in your programming with DRAW. The entire 
house is reduced in size based on your Scale instruction. This 
drawing, however, does not accurately reduce in size due to a 
couple of restrictions: 

1 ) We have specified certain starting points as x,y coordi- 
nates. When our drawing is reduced in size, those starting points 
may or may not be valid (in either smaller or larger sizes). 

2) If you were to draw a line 25 spaces long in Scale 4, then 
change the scale with S2 and redraw the line, it should be 12 l h 
spaces long. However, the computer cannot set half a space, so 
it rounds the value to the nearest whole number. In this case, the 
line would be 13 spaces long. In our program for the house, we 
have DRAWn lines, all of which are not evenly divisible by 2, 
which leads to shingles not being all on the roof, doors that are 
not attached where they should be, windows floating in space, 
and assorted other garbage scattered around on the screen. (Inci- 
dentally if you don't delete line 85 and lines 200-250, the results 
might be kind of interesting.) 

In any case, you should have sufficient fuel to keep the home 
fires burning until next month ... So, enough for now . . . 
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This month I would like to explain some misconceptions 
about the Pocket Computer, correct some errors which I have 
found in the Owner's Manual (OM) and explore some of the capa- 
bilities and features of the Pocket Computer more fully. 

Referring to page 1 of the OM under features, program 
capacity is stated as 1424 steps, 26 memories. Each step is equiv- 
alent to one byte and one memory is the same as 8 bytes. In 
addition to this there are 48 steps (bytes) of REServe program 
memory (see page 80). This yields a total of 1680 bytes of mem- 
ory which you can use. In addition there is an 80 character input 
buffer which allows you to input a maximum of 80 characters on 
one line including the line number but not including the first ":" 
(colon) following the line number. This last feature has lead to 
some confusion. As you input a line of code, each charact er you 
type takes up one byte of the input buffer (this includes the (ENTER) 
key). For instance typing "PRINT" takes 5 bytes but typing "PR." 
as the abbreviated form only takes 3 bytes. However, if you read 
the OM carefully, it will tell you on page 35 by implication in the 
example that each statement takes only one step. To illustrate this 
point, try entering the following line of code: 

950 PRINT"THIS IS A TEST OF THE" : PA, " INPUT CAPACITY OF 
THE": PR ."POCKET COMPUTER" (ENTER) 

You will no tice that the last quote mark is the 79th character and 
the (ENTER) key m akes th e 80th and acts as an instruction termi- 
nator. Now press (ENTER) and see what happens. When the dis- 
play returns it looks like this: 

950: PRINT "THIS IS A TEST OF THE":PAUSE "INPUT CAPACITY OF 
THE" :PRINT "POCKET COMPUTER" 

As you use the right arrow to examine the line of code you 
will notice that the first colon disappears from the display and 
does not return unless you re-display the line of code using the up 
or down arrow keys. If you count the number of characters 
(including sp aces) in the displayed line, there are a total of 87, 88 
including the (ENTER) ! By-the-way, if you start this experiment with 
nothing in your PC, you can use the MEM command to check the 
amount of memory steps used by subtracting from 1424. If you 
now move the cursor all the way to the right of the display, you 
will discover that you have room to add 8 more characters to this 
line. Try adding the following code right after the 'R' in 

COMPUTER: 

-12345678" and press (ENTER) . When the display returns go 
to the end of the line again an d you'l l notice that the last quote is 
missing. This is because the (ENTER) key took the place of it in 
memory. Another point to notice is that the Line number takes up 
exactly as many steps as there are digits. To check this, edit the 
preceding line of code so that the line number is 95 instead of 950 
and you'll find that you have another byte (step) of memory 
which you can use. This is not very clear in the example on page 
35 of the OM. 

Turning our attention now to page 24 and the logic functions, 
notice the paragraph marked with the * (asterisk). This paragraph 
is primarily concerned with operations performed in the direct 
mode from the keyboard. In the t wo exa mples, the = (equals) 
sign is meant to signify pressing the (ENTER) key. If you want to use 
these forms in an IF statement, leave off the = sign or if you want 
to put the result of the logical compare into a memory location 
you must use a form such as X = ( A< ) + (A >8 ) . This will 
load X with a one if A is greater than 8 or less than 0. If you want 
to create an XOR logical function (exclusive OR) try the following 
line of code: 



) + (O0):IF 1: 



SEEP2 



Using this format, the IF statement will be true only if B or C is 
greater than but not if both are greater than in which case X 
would return a 2 or if both B and C where equal to or less than 0, 
X would return a 0. 

As further explanation of the logical expressions, the plus 
sign serves to add the result of the first logical compare to the 
result of the second. This explains the return of a 2 in the second 
part of Note 1 at the bottom of page 24. Looking at Note 2 then, 
the * simply multiplies the result of one logical compare by the 
result of the next logical compare. In addition, these logical com- 
pares can be strung together using the + and * signs up to the 
limit of nested parentheses and/or data stages. By-the-way, the 
- (minus) and / (divide) signs can be used to provide some inter- 
esting and in some cases useful results. However, you should be 
aware of a possible divide -by-zero error if you try the latter form. 

Considering the examples then, if for instance we said 
>(= ( 5 + 8 ) > ( 3*4 ) , after pressing (INTER) . X would have a 
value of 1 . This will work the same way in a line of BASIC code 
and we could then use a statement such as I F X G TO 100 
and in this case the program would go to line 100. If we were to 
change the 8 to a 7 then X would return a value of and the pro- 
gram would go to the next line number to execute. If you would 
Like to prove this to yourself, try the following program: 



100: 


X=(X+li) - 


> (3*4) : PAUSE 


110: 


IF X BEEP 


K+1 :G0T0 100 


120: 


BEEP K+1 


GOTO 100 



When you run this program you will see X change (on the right of 
the display, see below for more on this) from 1 to and back 
while alternately hearing two beeps then one beep. 

Referring now to page 46 of your OM, let's have a look at 
spedfying variables in the fixed and flexible memories. First of all, 
there is an error in the paragraph marked by the third black dot. 
The sentence beginning "And E, B(5) . . ." etc. is completely 
wrong and should be marked out and the paragraph is now cor- 
rect. This correction should make clearer the fact that referencing 
flexible memories can only be done in the form A(n) or A$(n) 
where 'n' is a fixed memory (A thru Z), a numeric expression (ie 
3*4) or an indirect designation such as A(C) or A(3). Examination 
of the chart on page 47 should help to clarify this concept. An easy 
way to determine the highest flexible memory which can be used 
for data is to use the MEM command. Simply add the number of 
memories remaining to 26 to determine this highest address. A 
quick note, in the example under Flexible memory, A$(19*2) 
specifies flexible memory A$(38) and not A$(28). 

Turning to the bottom of page 52, the last sentence, the word 
'appear' should be 'disappear.' Over on page 53, the section under 
the No te:, the third sentence; the text refers to 'indexing the 
(SHIFT) and GD keys' . . . this means that if you are inputting 
a character variable such as ACCT#12, if you accidentally hit the 
" (quote) instead of the # (pound) sign, all input after the " (quote) 
will be ignored. 

Referring now to page 55, the first paragraph, second sen- 
tence; this sentence should read "The left section displays . . . and 
the right section another set." The right section displays the 
Expression only if it is in General Form (1). If you have used the 
PRINT statement at all, you have probably noticed this by now 
but I thought it was worth pointing out anyway 

(Continued on Page 13) 
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Compress Graphic Strings 

Dennis F. Tanner 

In educational applications, TRS-80 graphics can be effective 
in helping to convey, clarify, and emphasize the meaning of other 
information presented by the computer. 

Graphics may be produced with the TRS-80 Models I and III 
in a variety of ways: the SET and RESET statements, POKEing 
character values into the video RAM, and building them using 
character codes. One more method is determining a string vari- 
able's location in memory using the VARPTR statement, and 
POKEing character values directly in the variable storage area. 
This last method will be examined in depth in this article. 

For comparison's sake, let's first examine one of the other 
methods, building string variables using graphics codes. A graph- 
ics shape resembling a capital "H" may be created using this 
BASIC routine: 



10 C$= CHR$(157)+ 
20 PRINT C$ 



CHR$U40>+ CHR*(174) 



This works, but it uses space inefficiently On the right side of the 
assignment statement in line 10, twenty bytes of memory were 
used to build a three-character string! 



CHR$ 


used 3 times = 


= 3 bytes 


"(" and")" 


used 6 times = 


= 6 bytes 


" + " 


used 2 times = 


= 2 bytes 


Digits 


used 9 times = 


= 9 bytes 




Total 


-- 20 bytes 



String characters can be built much more efficiently by work- 
ing with the variable more directly Using the VARPTR statement, 
we can determine much about how variables are stored. From 
pages 8/13-8/14 of the Model I Level II BASIC Reference Manual, 
and pages 8/9-8/10 of the Model III BASIC Reference Manual, we 
find that this information is available to the BASIC programmer 
regarding the storage of string variables: 
VARPTR(string variable) — returns a memory location, K. 
PEEK(K) — returns the length of the string (variable). 
PEEK(K+ 1) — returns the least significant byte of the starting 

address where the variable is stored. 

PEEKCK + 2) — returns the most significant byte of the starting 

address. 
PEEK(K - 2) and PEEKCK - 1 )— when combined, return the ASCII 

code for the variable name. 
PEEK(K - 3) — returns a descriptor code identifying the variable 

type (the value 03 stands for string variables). 

Using this information, we can write the following program 
to give us information about a string variable: 

60000 Z%-- K UV 

60010 K= VARPTR(C$) : IF K>32767 THEN K= K- G553S 

G0020 PRINT "VARPTR =" K 

60030 PRINT "LENGTH OF STRING =" PEEK(K) 

60040 PRINT "LSB OF STARTING ADDRESS =" PEEK(K+1) 

S0050 PRINT "MSB OF STARTING ADDRESS =" PEEK(K+2) 

60060 S= PEEK (K+l ) + PEEK(K+2) * 256: IF S>32767 THEN 

S= S- 65536 
60070 PRINT "STARTING ADDRESS = " PEEK(K+1 ) "+" 

PEEK(K+2) "* 256 =" S 



60080 PRINT "CHARACTER CODE OF VARIABLE NAME =" 

PEEK(K-2)i PEEK(K-l) 
60090 PRINT "TYPE OF VARIABLE = " PEEK(K-3) 
60100 PRINT "ASCII CODES OF VARIABLE ="!: FOR J=0 TO 

PEEK(K)-1: M = S+J; IF MJ-32767 THEN M = M-65536 
60110 PRINT PEEK(M) ! : NEXT J: PRINT 
60120 PRINT "C$ =": PRINT C$ 

Now that we know exactly where each byte of the string vari- 
able is stored, we can POKE new values into those locations by 
adding the following lines to our program: 

B0130 FOR 1=1 TO PEEK(K) 

60140 PRINT "VALUE FOR BYTE" I!: INPUT V 

60150 M= S+ I- 1: IF M>32767 THEN M=M-65536 

60160 POKE M» V 

60170 NEXT I 

60180 GOTO 60000 

NOTES: 

1) This routine is designed to be appended to an existing pro- 
gram, as described later. After you have assigned graphics codes 
to all desired variables, the entire routine can be deleted. 

2) In this routine, the slashed lower case b ("16") is used to 
represent a space that is produced by pressing the space bar. 

If you run the program now, and input the values 157, 140, 
and 174 (the same values we used in our first program), the string 
variable C$ will contain the same characters as it did in the first 
program. 

When you list the program again, you will see something that 
you might not have expected. On the Model I, Line 60000 now 
reads: 



B0000 C$= 



■EDITLETSYSTEM' 



This is because you have POKEd the values for the individual 
parts of the character into the variable C$, and the computer inter- 
preted them as reserved words, as listed on page E/l of the Level 
II Manual. On a Model III, the listing of the line 60000 would con- 
tain the graphics string itself. 

Note that in lines 60010, 60060, 60100, and 60150 we com- 
pared the value of the memory location to 32767. This is because 
the memory locations "wrap around" to the negative locations. 
That is, for purposes of PEEKing and POKEing, these locations are 

in ascending order: 1, 2 32765, 32766, 32767, -32768, 

— 32767, —32766,... —3, —2, — 1. If the address of the location 
reaches 32769, for example, the program subtracts 65536 to 
compute the appropriate value, - 32767. 

We have now accomplished our goal. Line 60000 now 
assigns the graphics string with five bytes on the right side of the 
assignment statement (compared to the twenty we used before). 
If you don't believe it, PRINT LEN(C$) to be sure. The three bytes 
of the character, plus two sets of quotation marks, makes the five 
bytes. 

To use this routine to make your programs more efficient, 
append this program onto the end of your regular program. At the 
point in the program where you want to assign the characters to 
the string variable, make an assignment statement of the proper 
length, using all spaces. Here's an example using MA$ as the vari- 
able name: 

100 MA$= " K fcl IZI tf K fei tf K " 

101 GOTO G0010 

(remainder of main program) 

' (Continued on Page 23) 
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(From Page 22) 

Line 60000 may be DELETEd from the program since it will 
not be used. Line 60010 should be changed to read: 

60010 K= UARPTR(MA$) 

and line 60120 should read as follows: 

G0120 PRINT "MA$ = ": PRINT MA$ 

Since line 60000 has been DELETEd, line 60180 must be 
changed to read: 

G0180 END 

Then execute a RUN 100 to begin the program. Simply input 
the ASCII values you want to use for the variable, and they will be 
assigned to the variable. Note that the ASCII values for letters, num- 
bers, and other characters or codes may be used, too. 

After all your graphics variables have been assigned, the rou- 
tine at the end of the program (60010-60180) may be DELETEd 
from the program if you will not need it again. 
(Don't forget to DELETE line 101, too!) 

In closing, let me leave you with this coded message: 

MA$= "KBBKBBBBBBBBKBBIS" 

Use these values for data: 66, 89, 69, 33, 128, 132, 132, 132, 
132, 128, 68, 69, 78, 78, 73, 83. 



odel I/III Program 
ompatibiliiy 



Here is a summary of Radio Shack software, and how it does 
(or does not) work with a Model III: 

The following programs use one or more of the characters: 

CHR$(91) (Mod I— ♦, Mod III— [) 
CHR$(92) (Mod I— ♦, Mod III — \) 
CHR$(93) (Mod I— i Mod III—]) 
CHR$(94) (Mod I— *, Mod III—"): 

Budget Management 26-1603 

Casino Games 26- 1806 

Cassette Portfolio 26- 1506 

Games Pack I (Space Taxi) 26-1805 

Invasion Force 26- 1906 

K-8 Math 26-1715 

Level I BASIC Instruction Course 26-2003 

Level II BASIC Instruction Course— Part I 26-2005 

Level II BASIC Instruction Course— Part II 26-2006 

Micro Music 26-1902 

You should be aware of this and recognize which characters 
are used on the Model III video to represent the arrow of the 
Model I. Hint: I have trouble remembering which character is 
which arrow, so I taped the symbols to the front of the arrow keys 
on the keyboard. Now when I see an "arrow character [ \ ] A " I can 
look at the keyboard and match the character with the proper 
arrow. 

These differences are cosmetic only and do not affect the 
execution of the program. 

The following is a list of Model I programs which need minor 
corrections to allow them to function correctly in a Model III: 

Advanced Statistical Analysis 26-1705 

Budget Management 26-1603 

Casino Games 26-1806 

Cassette Mailing List 26-1503 

Cassette Portfolio 26-1506 

Dancing Demon 26- 1911 

Level II BASIC Instruction Course — Part II 26-2006 

Real Estate Volume III 26-1573 

Real Estate Volume IV 26- 1574 



The corrections to make these programs run on a Model III 
are included with the Model III. However, if you do not wish to 
make the changes yourself, ask your Radio Shack store manager 
to return the tape for exchange with the Model III version. 

The following programs cannot easily be changed to Model 
III versions. As we replenish our stock of these programs (and 
make the appropriate changes), we will include tapes or disks (as 
appropriate) for both Model I and III in the package. If the program 
is a disk program, it may be "convertible" rather than having disks 
for both Model I and Model III. We have gone back and reworked 
a lot of our warehouse stock, so you will have the Model III soft- 
ware as soon as possible. If you happen to get a copy of this soft- 
ware which does not contain the Model III version, ask your store 
manager to order the proper version for you. The 700-XXXX 
number shown is the Model III exchange version and will be pro- 
vided free of charge. If the package does not have a 700 number, 
or if it has the t symbol, we have not released the Model III 
exchange version yet, but one is coming. 

Business Mailing List 26- 1558 (700-22 12) 

K-8 Math 26-1715J 

Mailgram® 26-1564 (700-2004) 

Micro Movie 26-1903 t 

Microfiles 26-1565 (700-2012) 

Profile 26-1562 (700-2010) 

Scripsit®— Disk 26-1563 (700-2006) 

Scripsit®— Tape 26-1505 (700-2005) 

Standard and Poor's Stockpak® System 26-1507 t 

Versafile 26-1604 (700-2008) 

The following software will NOT run on a Model III, and is 
NOT available as an exchange item. Do not buy this software for 
a Model III computer! Most of the items in this list (or a package 
of a similar nature) will be (or are) available for the Model III (these 
are marked with an *). When available, the Model III version may 
be packed with the existing Model I program, or we may issue it 
as a new stock number for Model III only We will keep you 
informed about these programs through the Newsletter, and our 
local stores. 

Disk BASIC Instruction Course 26-2007 * 
Editor Assembler — Disk 26-2202 * 
Editor Assembler — Tape 26-2002 * 
Micro Chess 26-1901 * 
Renumber 26-2004 

RS-232 Communications Pack 26-1146 * 
RSTERM 26-1147* 
Space Warp 26-1912* 
T-Bug 26-2001* 
Tiny Pascal 26-2009 * 
TRS-80 FORTRAN 26-2201 * 
VisiCalc 26-1566 is available for Model III. 
All programs not mentioned above do not require modifica- 
tions to work on a Model III. 
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Line Draw 

Eddie Pont, Southfield MI 

I read your newsletter and enjoy its 
programs very much. The only thing 
missing in a lot of these programs is a 
chance for the user to create. 

This program for Level II Model I's, 
or Model Ill's with Model III BASIC will 
start a graphics line at 0,0 and move it to 
the right. The user has the ability (via the 
INKEY$ statement) to control the direc- 
tion of the line. It is very relaxing and can 
be fun for hours on end. 



REM 
REM 
REM 
REM 
3 CLS 
B$ = 
SET 
A$ = 
IF E 
IF i 
IF E 
B0 IF E 
90 A$=' 



1 

3 

5 

7 

10 

20 

30 

40 

50 

B0 

70 



LIN 
BY: 
"U" 
"R" 
: 
"R" 
(){, 
INK 



E DRAW 
EDDIE PONT*** JAN, 
UP: "D"=D0WN 
RIGHT: "L"=LEFT 
ERROR GOTO 150 



FOR T=l TO 
: IF LEN(A$) 



THEN 
THEN 
THEN 
THEN 



= Y-1 
= Y + 1 
= X+1 
■■){-! 



100: NEXT 
>0 GOTO IE 
GOTO 30 
GOTO 30 
GOTO 30 
GOTO 30 



GOTO 30 



10 GOTO 30 

50 IF ERR/2+l=5 GOTO 160 

ELSE RESUME 40 
160 PRINT! 896, "OUT OF RANGE' 
[70 A$=INKEY«: IF LEN(A$)=0 

GOTO 170 

PRINTS 896 »" 
[90 B$=A$: A$="": RESUME 50 



Mr. Pont notes that if you get the 
"OUT OF RANGE" error you must move 
in the opposite direction. 



System 

Andrew Koledin 

In the Jan. 1981 issue, you gave us a 
short program to find the name of a "SYS- 
TEM" tape on Model I. While that pro- 
gram does work, I have a much shorter 
program that you may pass on to your 
readers. It also finds the name and is very 
simple. You may print it in your Newslet- 
ter. (Just spell my name right!) 



10 CLEAR 300 

20 INPUT #-1 , A$ 

30 PRINT MID*(A$ »2»B) 



Editor's note: This works for both 
Model I and Model III System tapes. 



Burma Shave 

Here is a quick little program from 
Edward L. Wilkening II of North Holly- 
wood, CA which may bring back some 
memories for many of you: 

10 CLS: PRINT CHR$(23): A=14 
20 PRINTS 980, "EINI MINI": 

GOSUB 100 
30 PRINTS 980. "MINI MOE": 

GOSUB 100 
40 PRINT! 974, "COMPUTERS NEVER"! 

GOSUB 100 
50 PRINTS 980, "SAY HELLO": 

GOSUB 100 
60 PRINTS 978, "BURMA SHAVE": A=7: 

GOSBU 100 
70 FOR 1-- 1 TO 300: NEXT Z 
80 CLS: FOR 0= 1 TO 300: NEXT Q 
90 GOTO 10 
00 FOR N=l TO A 
10 FOR 1=1 TO 20: NEXT I 
20 PRINT 
30 NEXT N 
40 RETURN 
50 END 



More 
Computer Clubs 

Western New York TRS-80 Users Group 
c/o Nick Rekito 
6040 Baer Road 
Sanborn, N.Y. 14132 

Robert Stuart Computer Club 
Robert Stuart Junior High School 
Caswell Ave. W. 
Twin Falls, Idaho 83301 

Reno Computer Club 
P.O. Box 11874 
Reno, NV 89510 
702/322-7988 




COMPUTER SERVICES ADDRESS 
AND PHONE NUMBERS 
8AM to 7PM Central Time 
Computer Services 
900 Two Tandy Center 
Fort Worth, Texas 76102 
Model I/III Business Software 
Outside Texas 1-800-433-564 1 
In Texas 1-800-772-5973* 
Model II Business Software 

Outside Texas 1-800-433-5640 



In Texas 
All Other Calls 
Outside Texas 
In Texas 



1-800-772-5972* 

1-800-433-1679 
1-800-772-5914 



Switchboard— 1-817-390-3583 

* Available May 20, 1981 
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